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CHAPTER 1 
INTRODUCTION TO TIMESHARING AND EDUSYSTEM 50 

1.1 INTRODUCTION TO TIMESHARING CONCEPTS 



In a typical programming environment, a user may desire to have 
a computer edit, test, debug and execute a program. However, there 
9 are frequently long periods of time when the computer waits for input 
from the programmer. At these times, it is desirable to find some- 
thing else for the computer to do. One solution is called "time- 

11 sharing". Typically, a number of users each has a terminal connected 
to a computer, and as each user requires computer time, the processor 
assigns computer time to each user. Thus, by proper allocation of 

12 prpcessor time, each user, in effect, has all the computer time 
necessary for a particular program. Users do not have to feel rushed 
or be concerned about others who may desire to use the computer. 

EduSystem 50 is such a timesharing systen. From the user's 
viewpoint, each user on an EduSystem system has a terminal and 4K 
of core for his exclusive use. In addition, disk storage may be 
used on a first-come/first-serve basis. Any of the several peri- 
pherals connected to EduSystem 50 may be reserved by a user 
exclusively until completion of the program. The EduSystem 5 
Monitor is the set of programs which allows all of this to happen. 



The EduSystem 50 Monitor reserves fields and 1 for its 
exclusive use; the rest of core is given to users as they need it. 
Since there may not be enough core for every user to simultaneously 
occupy 4K, each user has a 4K section of disk reserved for his 
program. When there is not enough room in core, the entire 4K is 
written to disk. Later, when enough core is available, the 4K is 
read from the disk back into core again. This process is called 
swapping, and the area on disk reserved for it is called the swap 
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To pr^vent ^,mm^ from interfering with the operation of 
others, several steps are taken: 

a) An OSR is not allowed; this prevents disputes over 
the sv/itch register setting. 

b) The user cannot perform an HLT. 

c) The program must be executed with the data field set 
equal to the instruction field; no ch3nge is allowed 
in either. In fact, the user may not do any kind of 
lOT. 

In reality, any of the above instructions may be contained 
in a user's program. They are trapped by the hardware, which 
does not allow them to function. Instead, the time-share hard- 
ware option raises a flag and causes an interrupb. The Monitor 
must then determine the cause of the interrupt. If, for example, 
the user does a KRB, the AC will not be altered. Instead, the 
KRB causes an interrupt into Monitor code, which looks back to 
see what causes the interrupt. When is sees the JKRB, it takes 
the necessary steps to simulate the ICRB- It then returns to the 
oAser's program. Thus, there are 512 different lOTs the user" can 
execute; the Monitor could be modified to perform almost any 
desired function for them. These, trapped IpTs, and the trapped 
HLTs and OSRs are sometimes referred to an Unimpleuiented User 

Operations (UUOs) . „ . ,.v^ -; 

Tlie time-share hardware option makes this possible. #ie , 

t .... 

orocessor can be in one of two modes: executive mode and user 
lode. In executive mode, the processor operates like a stan- 
ard PDP-8. However, when the processor is in user mode, the 
instructions discussed above cause an interrupt, and return the 
processor to executive mode. 
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NOTE 



' : Instructions microcoded with HLT or OSR 
will complete their functions normally 
before the interrupt occurs, 

• ; To begin using the system the user must be identified at 
the terminal. Each user has an account number, under which disk 
files are stored. The Monitor also keeps track of system usage 
by account number. To protect against misuse of the , system, the 
user must give an account number and a password to the system: 
this process is called a LOGIN. 

Once logged in, the user may type various commands to the 
Monitor, execute a program (either original or from the library), 
or type characters to be input to the program. When finished, 
the user logs out enabling others to use the terminal. 

1.2 edusystem: so hardware configur?^tions 

A minimum configuration for EduSystem 50 includes: 

a) PDP-8, 81, or 8E, with at least 12K msmory (16K memory 
is better) and the time-share option. (All are referred 
to in the following text as PDP-8.) 

b) RF08 with at least one RS08 (a DF32 with at least two 
platters is acceptable, however, this is not recommended 
becausfj of the limited storage area and slow speed of 
the de'^rice) . 

c) Multi-terminal capability - one or more KL8Es or PT08s 
or a DC08A. 

All configurations, except PDP-8Is with a DC08A, require 
a real-time clock. 

Optional hardware supported: 

a) Up to 32K memory. 

b) DC08A - may be used only on a PDP-8I and may be used in 

addition to PT08s. 



c) 689AG modem controlle^r - for use with DC08A only. 

d) EAE- all instructions of any standard EAE are supported 
with the exception of the traditional PDP--8 step counter; 
which is not saved or restored. 

e) High-Speed Reader - a paper tape reader is required to 
build EduSystem. A low-speed reader may be used, however/ 
the build procedure v/ill be very time consuming. 

f) High-Speed Punch. 

g) Line Printer - LP08/LE8 or LS08/LS8E. -^ 

h) DECtape - TCOl or TC08 and up to eight drives ( TE'8E. 

DECtape is not allowed.) ■• 

i) Up to four disks (three additional RS08s) . 

j) Card Reader. 

k) RK8E (up to four drives). 

SOFTWARPJ 

The following sections present an introduction to the comp- 

t nrograms of EduSystem 50. 



1 INIT : ',. . 

INIT is the initializer program. It is the job of INIT to: 

a) Build a new system on the system disk from paper tapes. 

b) Initialize a file structure on the disk for program 

storage. 

• ■■■■,.■,'.,■, 

c) Allow the user to make patches to the system. This can 
be useful if a particular system feature must be altexed. 

d) Allow the user to transfer the entire contents of the 
disk to DECtape. This is called a "diimp". 

e) Allow the user to load the entire disk from DECtape. 
This allows all saved programs, account numbers/ etc. , 
to be restored to their condition when a dump was lasit 

taken . 

f) Allow the user to start the system so that it is in its 
operating state. A start must set up fields and 1 to 
the proper initial conditions, start the real time clock, 
and transfer control to the monitor. 
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1.3.2 SI. 

SI is the System Interpreter. Whenever a user types a command 
at the console, SI analyzes the command. SI is stored on the disk 
and is read into field 2 when it is needed. 

l;3.3 FIP 

FIP is the File Phantbm. Vilhenever certain lOTs (see Appendix C} 
ar$ executed, PIP is called in to handle theim. FIP handles disk 
file storage and assigns devices to users when they request them. 
PIP is also stored on the disk and, when it is needed, it is read 
into field 2. 

1.3.4 TS8 and TS8II 

TS8 and TS8II are the two sections of the resident Monitor 
which are resident (always present) in fields and 1, respect- 
ively. The resident code is responsible for: 

a) Scheduling - The scheduler decides who uses the computer 

and when. If the user types a comraand, the scheduler 
brings in SI. If more than one user wants a program to 
rujn, the scheduler distributes time to the users. If 
there is insufficient core for everyone to use at once, 
the scheduler swaps users to and f]:om the disk. 

b) UUO Handling - When the processor is in user mode, remembe 
that if a user executes any type of lOT, an HLT, or an OSR, 
The hardware does not execute the instruction, but causes 
an interrupt. The lOT, HLT, or OSR is called a UUO in thi 
case.. The Monitor has the job of simulating the function 
of the UUO, and possibly returning control to the user. 

By definition, resident UUOs are those which are handled b' 
the code residing in fields and 1. Non-resident UUOs 
must be handled by calling in FIP. 

c) Interrupt Handling - All I/O Interrupts must be isolated 
and handled by the Monitor. 

d) Keeping Time - Clock interrupts are counted and at certain 
intervals certain tasks must be perfoimied. 
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5 System Programs 

TTi ^re are several programs run by a user to perform certain 

anient operations. For example: 

a) PUTR - Used to transfer information from any device to 
another device. This is the new program which replaces 
the programs PIP and COPY which were operated under the 
previous version of the Monitor. 

b) BASIC - A major interactive compiler language. 

The list of programs is esctensive and is covered in more detail 
>r. 

NUMBERS AND TERMINOLOGY [ 

EduSystom 50 associates a number with each terminal. The 
linal v/ith device codes 03/04 is called, variously KOO, line 0, « 
[linal 0, or console 0. In order to accomplish anything, a user 
i terminal must "log in". To do this requires a 1 to 4 digit 
:o . number", and a to 4 character "password". When the user 
■^mpts to log in, the account number and password are given.. If ^ 
r are valid and if the system permits logging in, the £;yst«2m j; 
Lgns a "job number". When the user is through, a LOGOUT or .;; 
I command is required. At this time his account is chcirged 
the amount of time used. In this way system usage can be 
Ltcred . 

Sometimes account niombers are split into two, 2-digit num^bers 
separated by a comma. The first two digits are called the 

iect nuniber, and the last two digits are called the prograiraner 

Der. Account I, 2 is the same as account 0102. 

There are three permanently defined account numbers . Account 1. 
;:>ngs to the system manager. Anyone logged in under account 1 has' 
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certain priveleges no other person has, such as defining other 
account numbers and their passwords. However, doing certain things 
under account 1 could be detrimental to the system. Account 2 
belongs to the system librarian. The common programs are stored 
under account 2, and any user can access them there. Account 3 
belongs to the system operator who has certain privileges which 
are not as detrimental as those granted to account 1. 

1.5 SYSTEM CONVENTIONS 

The disk is divided into tracks. One track is defined as 4K 
(4096 words) of disk storage. (Two revolutions of an RF08, four 
revolutions of a DF32D, eight revolutions of a DF32.) Thus, track 
refers to the first 4096 words of storage on the RF08 or DF32. One 
segment is defined as two pages, 400 (octal) or 256 (decimal) words 
of disk storage. All disk files are measured in segments. 

Unless otherwise noted, all commands and responses typed by 
the user should be terminated with a carriage return. 
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CaPiPTER 2 
BUILDING EDUSYSTEM 50 FROM PAI'ER TAPE 

2.1 BUILDING EDUSYSTEM 50 

Building an EduSystem 50 software system is accomplshed in four 
phases . 

I)' Loading and initializing the Monitor. 

II) Building the system program library. 

Ill) Defining account numtiers , passwords and quotas. 

IV) Dumping the newly built system to DECtape. 

phase I requires the four custom-made Monitor paper tapes 
(31, FIP, INIT, and TS8) plus the binary paper tape for PUTR, 
These paper tapes will be loaded onto the system disk after which 
a number of questions will be asked. 

Phase II is accomplished with the Edusystem 50 software running. 
The system library is built in one of three ways , depending upon 
which medium system library programs are distributed on. If the 
library is distributed on DECtape, this step requires the library 
DECtape. If the library is distributed on an RK05 cartridge, this 
step requires the library cartridge. If the library is distributed 
on paper tapes, 'this step requires the library paper tapes. 

Phase III is also done while the EduSystem-50 Monitor is in 
operation and uses the program LOGID to define user accounts. 

Phase IV applies only to systems which include DECtape, It Is 
accomplished by running EduSystem 50 "INIT". 

2.2 BUILD PROCEDURE 

I. LOADING AND INITIALIZATION 

1,. Turn computer power key to POWER (ON) 

2. Turn the conole terminal ON (LINE or REMOTE). 

3. Turn high speed reader ON 

4. Lower, then raise the HALT switch. 

NOTE: On PDP-8/I, to 'LOWER' a switch means press 
the top of the switch in, 'RAISE' means push Tine 
bottom of the switch in. 

5. Raise the SING STEP switch. Lower the DATA FIELD 
and INSTRUCTION FIELD switches if included on ycvjr 
computer (PDP-8 and PDP-8/I) , 

6. Press the CLEAR switch, (not present on PDP-8 or 
PDP-8/I) . 
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For each step in the table, place each of the console 
switches numbered to 11 either in the up position if 
the corresponding table entry is 1, or in the down 
position if the correspondincj table entry is 0. When 
all 12 switches have been set to corr€;spond to a line 
in the table, follow the instructions in the right 
hand column and proceed to the next line. The tables 
also include octal values of the binary switch settings 
for the benefit of users familiar with octal numbers. 



Table 2-1 
RIM Loader Program (High-speed version) 



iCOp 


Ort.ll 




Switrh WTIf'BJBI 


BPV 


! 


1 


Vjlijpr. 




Sotting 




And Ihon 








012 


345 


678 


91011 






1 


0000 


000 


000 


000 


000 


press EXTD ADDR LOAD 


2 


7756 


111 


111 


101 


no 


press ADDH LOAD 


3 


6032 


110 


000 


on 


010 . 


lift DCr key 


4 


6031 


110 


000 


on 


001 


lift DFP key 


5 


535 7 


101 


Oil 


101 


111 


lift DEP key 


6 


6016 


110 


000 


on 


no 


lift DEP key 


7 


7106 


ill 


001 


000- 


no 


lift DEP P.cy 


8 


700G 


111 


000 


000 


no 


lift DHP key 


9 


7510 


111 


101 


001 


000 


lift OEP key 


10 


5357 


101 


oil 


101 


111 


lift DCP key 


11 


7006 


111 


000 


000 


no 


lift or.P key 


12 


6031 


110 


000 


on 


001 


lift DEP key 


13 


5367 


101 


on 


no 


111 


lift DF.P key 


14 


6034 


110 


000 


on 


100 


lift Dtp key 


15 


7420 


111 


100 


010 


000 


lift DEP key 


16 


3776 


oil 


111 


111 


no 


lift DEP key 


17 


3376 


on 


on 


111 


110 


lift OnP key 


1 '' 


5356 


101 


on 


101 


no 


lift DCP key 


1 1 

TABLE 


ir-2. 


1 

niM LOAOCR F 


OR HIGII- 


SPEED READER 


Stop 
1 


Cctdl 
Valuos 


s 


witcii nuTii'wai 

Setting 


■r 


And Then 








012 


345 


673 


91011 






1 


0000 


000 


000 


000 


000 


press EXTU AOOH LOAD 




2 


7756 


111 


111 


101 


no 


prc'is ADDR LOAD 




3 


60 14 


liO 


000 


001 


100 


lift, DEP key 




4 


6011 


110 


000 


001 


001 


lift DEP key 




5 


5357 


101 


on 


101 


in 


lift DEP key 




6 


6C16 


110 


000 


001 


no 


lift DEP key 




7 


7100 


111 


001 


000 


no 


lift DEP key 




8 


700 6 


111 


000 


000 


no 


lift nivP key 




9 


7510 


111 


101 


001 


000 


lift DEP key 




10 


5374 


101 


on 


111 


100 


lift DEP key 




11 ■ 


7006 


111 


000 


000 


no 


1 ift OEP key 




12 


6011 


no 


000 


001 


001 


lift OEP key 




13 


5367 


101 


on 


no 


in 


lift DEP key 




14 


6016 


110 


000 


001 


no 


lift DEP key 




15 


7 4 20 


111 


100 


010 


000 


lift DF.P key 




16 


3776 


oil 


ill 


in 


no 


lift OEP key i 




17 


3376 


oil 


on 


in 


no 


lift DEP key i 


18 


5357 


101 


on 


101 


lU 


lift DEP key 













._._..-- 


-■ .-_-.. 
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After RIM has been loaded, it is good programming 
practice to verify that all instructions were stored 
properly. This can be done by performing the steps 
illustrated in Figure 2-3 



PRESS CLEAR 



SET ROTARY 
SELECTOR 
SWITCH TO MD 




PRESS EXTD 
ADDR LOAD 



SET SWITCHES 
TO 7756 



j PRESS ADDR 
LOAD 



SET SWITCHES= 
FIRST INSTRUCTION 



LIFT DEP 



SET SWITCHES== 
NEXT INSTRUCTION 




PRESS CLEAR 



SET ROTARY 
INDICATOR 
SWITCH TO MD 



SET ALL 

SWITCHES 

DOWN 




Figure 2-3 Checking the RIM Loader 



12. After the RIM loader has been deposited and checked, raise 
switches 0,1,2,3,4,5,6,8,9, and 10; lower switches 7 and 11; 

then press ADDR LOAD. f't^~ f f T "^^ <^t "^^i 

(X ^ ^ .'^-' 6 

13. Press the CLEAR switch; then press the CONT switch. If your 

PDF -8 has no CLEAR switch press the START switch. 



(figure E-5 on next page) 
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. I 



Y.. 



:c 



SET ROTARY 
SLL,CCxQU 
KWITCr.' 'I'O MD 



HIGH SPEED 



READER 



TURr: H.S. 
READER ON 



PLACE I JIT 
, IN H , S . a , 



^1^- 



SET ALL 

SWITCHES 

POWN. 



PRESS 
F.XTD ADiM. LOAD 



i: 



SET SWITCHES 
TO 77 5 G 



I ADDR hCnd) 





^-tjl^C^O 



LOW STEED 




READER 






^ 


( 




TURtT TTY TO 
LINE 




N 


1 




PLACE in::t 

IN L.S.R. 



PUT L.S.R TO 
START 



14. If the paper tape fails to read in at this point 
go back to step 1. 

15. When the paper tape stops the message: 

LOAD* DUMP* START* ETC? 

will be printed on the console. If this does not 
occur, go back to step 1. 

16. Type BUILD followed by a RETURN. The system prints: 

BUILD? 

Respond YES, followed by a RETURN, (labeled CR on 
some terminals) . 

17. The system prints: 

SI f 

Place the paper tape 'SI' in the reader and type a 
RETURN. The tape will read in. If an error occurs 
while reading a tape, the wrong tape was loaded 
the system will print: 

TAPE READ ERROR OR PLEASE TRY AGAIH 
PLEASE TRY AGAIN SI t 

SI t 

In either case, reload the requested tape ('SI' in 
this example) and type a RETURN . 

18. After successfully reading 'SI' the system will 
lequest the paper tape 'FIP' be placed in the 
reader and the RETURN key typed, exactly as when 
loading the 'SI' tape, 

19. Next the tape 'INIT' will be requested. This is the 
£;ame tape which was previously loaded. 

20. Next the tape 'TS8' will be requested. 

21. Lastly the tape 'PUTR* will be requested. 

If all Monitor subprograms have been loaded without 
difficulty, the printout on the console will appear 
ais shown below. 

LOAD* DUMP* START* ETC? BUILD 
BUILD? YES 

SI t 
FIP t 
INIT ♦ 

TS8 t 
PUTR t 



:?^ 



22. Next the sys.tem will print: 

ft|EW LOGIN MESSAGE? 

The reply should be ^ES or NO, clepending on wheth* 
yott. want to have a messuage printed on each console 
whiliever it is logged in J""*^ The message may be a 
greeting, caution, special instruction, or anythini 
else you desire as long as the message has no more 
than 127 ch^acters . Each RETURN counts as two 
characters. 

%If the reply is NO the system will print its next 
4^5,^7^ (go to step 23). However, if the reply is > 
YES^> the system will print: 

END WITH ALTMODE 

and position the console paper so that your messagi 

can be typed on the next line. After typing the.; 

message, you should end by typing the 2\LT MODE key' 

(ALT MODE is labeled ESC on some terminals.) The] 

printout and an example message would appear as 
shown below. 

NEW LOGIN MESSAGE? YES 

END WITH ALTMODE 

CONGRATULATIONS. YOU ARE NOW ON-LINE WITH EDUSYSt 

REPORT ANY PROBLEMS BY RUNNING "GRIPE '••$ 

When typing the ALT MODE key at the end of the mef 
a dollar sign ($) will be printed as shown above. 

23. The system asks: 

LOAD EXEC DDT AT START -irP? 

Respond NO, followed by RETURN. 

24. The next query asks you to ; specify the number of 
core fields available for user programs. Type a 
number which is two less than the number of 4K fi^; 
on the system, then type a RETURN. If the system I 
4 fields (16K of core) for 'Example , the response s| 
be 2 as below. ^ 

# USER FIELDS - 2 

25. The system asks whether the CTRL/S feature is desi 

This feature, which allows terminal output to be 
stopped by typing CTRL/S and restarted by typing 

CTRL/ Q , IS paruiculariy useful en viiac terminals 
such as the VT0 5 and VT50. Respond YES or NO,. fo| 
by a RETURN. 

ENABLE ts FEATURE? YES 
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26. Next, the power frequency may be requested. If the 
power is 60 Hertz (normal in North America) respond 
YES; if not, respond NO, then type a llETURN. 

60 HERTZ POWER? YES 

27. The system asks whether the system disk should be 
zeroed. Respond YES, followed by a RICTURN. 

WftlTE'ZERO SYSTEM DIRECTORY? YES 

28. Three passwords are requested, for accounts 1, 
2, and 3. Enter these passwords, which may each 

be up to four characters long, followed by a RETURN. 

f SYSTEM PASSWORD? SYST 
' 5L LIBRARY PASSWORD? LIBR 

J OPERATOR PASSWORD? OPER 

29. The question "LOAD, DUMP, START, ETC??" is again 
printed. This time respond START followed by a 
RETURN . 

LOAD* DUMP* START* ETC? START 

30. When requested enter the current month, day, and 
year separated by hyphens followed by RETURN. 

MONTH-DAY -YEARI 1-23-75 

31. Next type the time of day expressed in military time 
using a 24-hour clock. Separate the hour and minutes 
with a colon. For example, 9:45 a.m. is entered 
9:45, 1:30 p.m. is 13:30, 9:45 p.m. is 21:45. 

HRIMIN - I3tl8 



No additional questions will be asked after the time 
has been entered. This completes Phase I of the 

building process. 

Your printout to this point might appear as follows: 

LOAD* DUMP* START* ETC? BUILD 
BUILD? YES 

SI t 
FIP t 
I NIT » 

TS8 t 

PUTR t 

NEW LOGIN MESSAGE? YES 

END WITH ALTMODE 

CONGRATULATIONS. YOU ARE NOW ON-LINE WITH EDUSYSTEM-SO . 

REPORT ANY PROBLEMS BY RUNNING "•QR I ?£**•» 

LOAD EXEC DDT AT START-UP? NO 
# USER FIELDS - 2 
ENABLE tS FEATURE? YES 
60 HERTZ POWER? YES 

WRITE ZERO SYSTEM DIRECTORY? YES 
SYSTEM PASSWORD? SYST 
LIBRARY PASSWORD? LIBR 
OPERATOR PASSWORD? OPER 

LOAD* DUMP* START* ETC? START 

MONTH -DAY -Y EAR t 1-23-75 
HRtMIN - 13 J 18 

After entering the time of day and terminating the 
line with the RETURN key, control is transfered 
to the Edusystem-50 monitor. The system is now 
on-line and ready to operate. However , there are no 
programs in the system library. 

BUILDING THE SYSTEM LIBRARY 

Building up the system library is done while the 
system is on-line, i.e., operational and running. 

1. LOGIN with the system library account number 
and password. Type 

LOGIN 2 LIBR 

replacing LIBR with the password for the library 
account. Terminate this .LOGIN command with the 
RETURN key. ; 

The command LOGIN and account number and password 
will not echo (print) on the console paper. 
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When the LOGIN is accomplished, Monitor prints 
the version numl:)er of the Edusystem-50 Monitor 
being used, the job number assigned by the Monitor, 
the account number of the job, the number of the 
console being used, and the current time of day. 

The login message is printed next, followed by 
Monitor's dot indicating that the building session 
has been successful to this point. For Example: 

TSS/8*24 JOB 01 t&0»&21 K00 13U8S 10 

CONGRATULATIONS • YOU ARE NOW ON-LINE WITH EDUSySTEM-50« 
REPORT AMY PROBLEMS BY RUNNING "GRIPE". 

Type "START 0" follov/ed by a RETUI^. 
This starts the program PUTR which was loaded 
during the build process. PUTR prints as 
asterisk, indicating that it is ready to accept 
a command , 

•START 



At this time, one of three procedures must be 
followed depending upon whether the library programs 
.are supplied on paper tapes, Dectc.pes, or RK05 

disk. If the library is on paper tapes, follow the 
steps in section A) below. If the library is on 
DECtape, follow the steps in section B) , and if the 
libr.ary is on RK05 disk, follow the steps in section 
C). 

A) The following steps are used to build the sys- 
tem library from paper tapes. First the system 
programs will be loaded, (those labelled 
"name.SAV", eg BASIC. SAV) 

1) Load the paper tape labeled LOGOUT. SAV in 
the high speed reader. In response to the 
* which PUTR has printed, type: 

COPY L0C50UT.SAV"PTR:/SAV 

and terminate the line with a RETURN. 
PUTR will print "t"» Respond by typing a 
RETURN. PUTR will print "NONAME . " , read 
the tape, and then print another *. 



2) 53tep 1 should now be repeated for any 
other ".SAV" tapes to be loaded, sub~ 
stituting the name of the tape for 
"LOGOUT" in the COPY coininand . For 
example, if the tapes LOGID.SAV, BASIC. SAV, 
SYSTAT.SAV and PUTR2.SAV are loaded, the 
printout would appear as follows: 

♦copy LOGID«SAV»PTRl/SAV 
f 

NONAME* 

♦COPY BASIC.SAV«PTRl/SAV 
f 

NONAME* 

♦COPY SYSTAT.SAV«PTR:/SAV 
t 

NONAME. 

♦COPY PUTR8.SAV«PTRI/SAV 
t 

NONAME. 

As a minimum include at least LOGID.SAV, 
LOGOUT. SAV and PUTR2.SAV. 

3) When all the desired ".SAV" tapes have 
been loaded type EXIT in responses to the 
asterisk, followed by a RETURN. 

4) Next type "R PUTR2" in response to the 
period the Monitor has printed at the left 
margin. PUTR2 will print an asterisk. The 
printout should appear as follows: 

♦ EXIT /''' 

tBS i 

•R PUTR2 

♦ 

5) If BASIC is loaded and it is desired to 

load some of the BASIC demonstration prograims, 
("name.BAS") load the desired tape into the 
reader and type, for example: 

COPY FTBALL«BAS/BAS«PTRJ 

replacing FTBALL with the name on the tape. 
PUTR will respond as it did in Step 1. 
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6) If it is desired to load any ASCII paper 
tapes, ("name.ASC") load the desired tape 
into the reader and type, for example: 

COPY WDGAME.ASC/TS8=PTRi 

replacing WDGAME with the name on the 
tape. PUTR will respond as it did in 
Step 1. 

Focal tapes ("name.FCL") must be loaded 
from the terminal using FOCAL. 

7) When all tapes have been loaded type EXIT 
in response to the asterisk printed by 
PUTR followed by a RETURN, 

8) Next type LOGOUT in response to the period 
the Monitor has printed at the left margin 

This completes phase two of the building 
process. Now go to Phase III. 
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B) The following steps are used to build the 
system library from the library DECtape. 

1) Mount the library DECtape on unit 1;, 

(see chapter 4 Introduction to Programming 
for complete instruction) and write lock 
the unit. In response to the * printed by 
PUTR, type the following command line: 

COPY ♦-Dlt 

This command requests that all files on 
DECtape unit 1 be transferred to the system 

disk. 

As each file is transferred, PUTR will type 
its name. When finished, PUTR will type 
another * . 

2) In response to the *, type EXIT. 

3) Next type "R PUTR2" in response to the 
period the Monitor has printed at the left 
margin. PUTR2 will print an asterisk. 

The printout for this step should appear 
as follows: 

♦ EXIT 

TBS 

•R PUTR2 

4) In response to the asterisk, type EXIT, 
followed by a RETURN. 

5) Next type LOGOUT in response to the 
period that the Monitor has printed at 
the left margin. 

This completes phase tv/o of the building 
process. Now go to Phase III, 
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C) The following steps are used to build the 

system library from the library RK)2f5 cartridge. 

1) Mount the library cartridge in unit J3 , and 
writelock the unit. In response to the * 
printed by PUTR, type the following command 
line: 

COPY >«RKA0I 

This instructs PUTR to copy all programs 
from the first half of the cartridge to the 
system library. 

As each file is transferred, PUTR will type 
its name. When finished, PUTR will type 
another *. (The second half of the cart- 
ridge is a duplicate of the first half. To , 
use this second half, substitute RKBJ3 for 
RKAd.) 

2) In response to the *, type E or EXIT. 

3) Next type "R PUTR2" in response to the 
period the Monitor has printed at the left 
margin. PUTR2 will print an asterisk. 

The printout for this step should appear 
as follows: 

♦ EXIT 

•R PUTRa 

♦ 

4) In response to the asterisk type EXIT, followed 
by a RETURN 

5) Next type LOGOUT in response to the period that 
the Monitor has printed at the left margin. 

This completes phase two of the building 
process. Now go to Phase III. 
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III. Defining Account Numbers, Passwords and Quotas. 

Users should never operate under accounts 1,2, or 3, -*:hGreforQ; 
it is necessary to define additional accounts. Acf'Ojnfcs can i 
only be created by the systjem manager? someone logcjGd in under, 
account number one. Each account is actually :v/o numbers, a J 
project number and a programmer number. Accou:it niimbor 5440 
is actually project number 54, prograr[imer numb.^r 40. Account /; 
number 102 is project number 1, progrcimmer numl^er 2. Users, - 
may specify that all other users may share their filv-is, only • 
users whose project number is the same, or no (Dther users at 
all. See the Protect command in Appendix B fo.r det5.ils. In ^^ 
defining new account numbers it is useful to group users into /: 
projects, giving them account numbers which have a ccmmon ' 
project number. , : rf 

As each account is defined the system manager also cieterraines ■■ 
the maximum number of disk segments that the account: may own* ;; : 
This is the quota for the account and is defined in irultiples f 
of tv/enty-five (25) segments; a minimum of s<2gmentf} to a' : 
maximum of 1575. For normal use 50 - 100 segments will suffice, j 

• ,■,.. ■> 
llie system manager also defines another parameter knotm as the T 
"Grace Quota". This parameter applies equally to all accounts.^ 
Tlie "Grace Quota" defines the number of segments eaQlf, account . 
may exceed its quota by for purposes of completing q program 
run. When an account's quota has been exceed the monitor will ■ 
not allow any new files to be Created for that accoi ;t, however: 
any files already belonging to the account may be e>,r.Gnded in ; 
lenth until the "Grace Quota" has been reached. At the time t};^; 
system passwords for accounts 1,2 and 3 were defineci the "Grace 
Quota" was automatically set to 10 secjments and the quotas for ^ 
accounts 2 and 3 were set to maximum* 

Passwords and quotas, including the "Grace Quota", may be ^ 
changed at any time by the system manager and //ill Irike effect " 
immediately. Account numbers cannot be changed, however accou^f 
m,ay be deleted, provided the account is not being used. > 

LOGID is the program used to create the, user accounts and modifr;, 
passwords and quotas. Since it can only be used by the system | 
manager the next step requires that a console be logged in' • f 
under account 1. The following responces should be terminated '|^ 
with the RETURN key. : 

„ i' 
1, ) Tvpe: ■'■ 

LOGIN I SYST 

replacing SYST with the system password given during phase] 
I step 28. The LOGIN command will not print oii the '; 
terminal. 

2.) Next LOGID must be called by typing: 

.R LOGID 
LOGID prints opening instructions, and then asks: , 
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PLEASE eiTER DISK QUOTAS 

Eater a number whi c/h is a multiple of 25 (^'-1575). ITiis 
nuir^ber will i:e used as the disk quota for tha accounts 
defiri^^ or clnanged from this point on. 

*£jQj0 now jprints an asterisk and waits for an account 
nm?iber, password combination separated by one space, B^ach 
Recount number can be from 1 to 4 octal digits (no 8's or 
^»s). Each password is made up of a maximum of 4 charact'-\i-n 
(all printable characters are legal). A maximum of 111 
different accounts may be defined, (10'8 user accounts plan 
the 3 system accounts). 

<3rv^ing CTRL/C causes LOGID to ask for the disk quota again » 
•Ilierefore a nuiiiber of accounts can be entered using one quota 
and then typing CTRL/C allows a new quota to be entered for 
tiie next group of accounts v/hich are defined. An example 
^Sdiloctue might appear as follows: 

- ^ TSS8.24,JOB-01 {00,01) K04 13:30:08 ; 



.R LOGID 

TSS8 ACCOUNT MAINTENANCE — 
;.;. *ACC'T # <SPACE^ PASSWORD ^RETURN TO CRFATE/CITANnK, 

ALTMODE TO DELETE> 

PLF:ASE ENTER DISK QUOTA: 100 

^'10 DEMO 
' - * 732 TOUR 

* 121S JOHN 
, '. * 1066 HARD 

* 1000 OTTO 

PLEASE ENTER DISK QUOTA: 75 
^ 1105 DECM 

^6 change the password' or disk quota for an account, type the 
account number and old password as above, followed by a RrH'UKN. 
£oGID v/ill ask for a new password. Enter the new passv/ord md 
tvt3e RETURN. ; If only the quota is being changed simply tync 
the RETURN key, no new password need be entered. In oith.^:: 
case the quota last entered into LOGID will be applied t:o rh.o 
account. For example: . 

« 1066 HARO 

CHANGE PASSWORD TO: D%8N 

PLEASE EMTER DISK QUOTA! 150 

* 732 TCUH 

" CHANGE PASSWORD TOt 

* 1 DEMO 

CHAMGE PASSUORD TO: PLAY 

* . . 



2-16 



The disk qijota does not apply to ticcount 1. However, 
whenever the system manager's passv7ord is changed LOGID v/ill 
request that the ''Grace Quota" be entered. For example: 

♦ I SYST 

CHANGE PASSVfORD TO J MMGR 
GRACE? 29 

To change both password and "Grace Quota" or simply: 

* I MNGR 

CHANGE PASSWORD TOr 
GRACE X 18 



to retain the current password but change the "Grace Quota" 

To delete an account type the account number and password as 
above but instead of typing the RETURJSI key, tvpe the Altmodc 
(ESC) dey. If the account is not being used all files 
belonging to the account will be deleted, ther the account w:i 
be deleted. When the account has been completely deleted tha 
message: 

S DELETED ' 

Will be printed to the right of the password ais below: 

* 1215 JOHN S DELETED 

♦ 

^^Then all desired accounts have been defined, type CTRL/B 
followed by S and RETURN. 

* »BS 



In order to create a listing of the -accounts that have been 
entered the program CAT should be run as belo^v: 

•R CAT 
SYSTEM ACCOUNT 26-FEB-75 10:1880(3 
PASSWORD CPU DEV DISK QUOTA 



1 00 J 00 1 00 00tUs05 , 12 18 <GRAC; 

2 00100800 00:00800 373 1575 

3 00J01M0 01136825 41 1575 
10 PLAY 00:00:00 00:00:00 150 

732 TOUR 00:00:00 00:00:00 150 
1066 D%8N 00:00:00 ■■ 00:00800 75 
1000 OTTO 00500:00 00:00:00 9 100 
1105 DEC^3 _ 00_:j30_'00_^ 00J00J 00^ L -0 X^ 
RESET: YES 

»BS ' •'■:■"';■ 

RESET function causes the CPU and DEVICE time accumulator 
all accounts to be set to zero, .Running CAT by typing 

cause CAT to skip its listing phase and immediatei 



The 

for 

CAT:R will 

ask RESET? 
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•LOGOUT 

To complete phase III of the Build process type IX)GOUT in 
response to the dot monitor has printed at tlie left margin. 

JOB 1* USEH C 0* I 3 LOGGED OFF K00 AT 10tl8t57 ON 26 FEB 7-5 
RUNTIME e0800J01 ( 0. CPU UNITS) 
ELAPSED mm 00 J 03 1 24 

This completes phase III. If the system configuration includes 
DECtape continue with phase IV, otherwise this concludes the 
BUILDING process. EDUsystem-50 is ready to use. 

Dumping the System To DECtape 

To dump the newly completed system onto DECtape, restart 
INIT. as follows: 

1.) Lower, then Raise the HALT (STOP) switch. 

2.) Raise switches ^ and 4; lower switches 1,2,3,5,6,7,8 

9,10, and 11. (The sv/itches are now set equivalent to 
4200 octal, the normal re-start address for Edusystem-50. ) 

3.) Press ADDR LOAD, then EXTD ADDR LOAD, then CLEAR, then 
CONT. (PDP-8 and PDP-8/I press ADDR LOAD, then START.) 

4.) INIT will print the message: 

LOAD* DUMP, START* ETC? 

I^OTE: Foi' simplicity, these instructions assume a system 
wit,h one disk and at least two DECtapes. For other 
sy£item configurations, see the general instructions . 
in Section B. 

i\. ^BKt mount DECtapes on units 1 and 2. Then set units 
1 and 2 to WRITE ENABLE (see chapter 4 Introduction to 
Pr ogr<^mminq for complete instructions) . Then type 
DUMP. INIT will copy an image of the entire system 
onto the DECtapes. 

When INIT again prints: 

LOAD* DUMP* START* ETC? 

the entire system has been copied. Remove the DECtapes 
and write some identification on the DECtape spools 
before filing them. To make the system available for 
use again, respond by typing START and complete the system 
startup procedure. (As in phase I steps 29 throught 31) 

3. General Instructions for Dumping Disks to DECtape ~ 

The contents of an RS08 disk (236K 'words) will noc quite 
fit en a single DECtape (190K words) . Part of a second 
tape is required. In general: 

Disks DECtapes 

1 2 

2 3 

3 5 



Thus, for a one-disk system, the LOAD and DUMP process 
requires two tapes. Loading and dumping always proceeds 
as follows: The DECtape selected as unit one (1) is 
used first, then DECtape 2, then, if necessair;^, units 
3,4,5, and 6. If the system includes as many DECtape 
drives as are indicated in the table above, setting up 
for a LOAD or DUMP is very simpler. Select consecutive 
units, starting with unit 1 and mount the appropriate 
DECtapes. The LOAD or DUMP routine will acce£5s them in 
order. 

If there are not as many tape units as there cire DECtapes 
to be loaded or dumped, it is necessary to use them more 
than once. Tlie LOAD and DUMP routines work as follows: 
they use DECtape 1, then look for DECtape 2. If they 
find it available (i.e., a DECtape unit has been selected 
as unit 2) the transfer continues on this unit. Then, 
if a third DECtape is needed, the routines lock for unit 
3. If at any point a unit is sought but Jiot found, the 
routines wait for it to be selected. Therefore, it is 
possible to load the first tape of the system on unit 
one, dismount the tape, place the second -:ape on the 
same DECtape unit, switch it to unit two, and have the 
load continue automatically at that point.. The following 
procedure will dump the contents of two d:.sks on a system 
with two DECtape drives. (Assume that fho. system has just 
typed out LOAD, DUMP, START, ETC?.) First set the 
DECtapes to units 1 and 2 and write enabl^i. Mount two 
scratch tapes on these units labeled TAPE ONE and TAPE 
TWO. Now type DUMP. The system will comj)letely write 
DECtape 1, then automatically go on to DECtape 2, 
After the tape on unit 1 has re-wound, dismount it and 
mount a third DECtape on this unit, labeled TAPE THREE 
set the unit select to three, and then as the last 
step, switch the unit to REMOTE. There is no need to, 
hurry. If vnit 3 is not ready when it is needed, the 
system will wait for it. The same procedure is followed 
for a LOAD. 

This same general procedure is followed for any system 
where there are not enough DECtapes to select them all 
simultaneously. 

When INIT again prints: 

LOAD* DUMP* START* ETC? 

the entire system has been copied., Remove the DECtapes 
from the spindles and write some identification on the 
DECtape spools before filing them. To make the system 
available for use again, respond by typing START and com- 
plete the system startup procedure. (As in phase I steps 
29 through 31.) 
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CimPTER 3 
PATCHING laDUSYSTEM 50 



tha information in this chapter is not necessary to operate 
rjysystem 50. Most system managers will use the Edusystem 50 
5St.'"tware exactly as it is supplied. Other users, however, will 
^^ant to make minor modifications or, in some instances, major syster 
rlunges. T!his chapter describes the tools available for making sue} 



},l MODIFYING SYSTEM LIBRARY PROGRAMS 



^.^^^ifying system library progrsims is an on-line process. Users \ 
"-« familiar with Edusystem 50' s advanced Monitor commands v/ill 



who 
familiar with Edusystem 50' s advanced Monitor commands v/ill fine 
^'t"a simple procedure. Log in with the library password, load the 
".♦crram into core, deposit the patches, then save the program again. 



rf^f example, a user may wish to modify EDIT so that it considers eve 
'^♦xth character position to be a tab stop. The process is as follow 
^*f the 1970 version of Edusystem 50 EDIT: 

.LOAD EDIT 
.DEPOSIT 2 -6 
•SAVE EDIT 

f-^Xf is now changed on the disk. If the system includes DEC tape, 
.^•=,—0 the whole system so that the changed version is stored on the 
Hac'<uD tape. If the system docjs not include DECtape, but has a higl 
'^'•ced^pu^^'^' a new SAVE format paper tape should be punched with 
til^2* Othe:rwise, the change must be made everytime the system is 
^uilt. Other system library programs may be modified in a similar 
r.anner. 

3^2 MODIFYING EDUSYSTEM 50 

A formal procedure exists for making patches to the Monitor. In 
r-der to understand this procedure, it is necessary to understand 
>-w Edusystem 50 is stored on the disk. The five pieces of 
♦'^nitor (SI, PIP, INIT, TS8, TS8II) are kept on the first 20PC of 
'X'q disk. Their respective disk addresses are: 

SI 00000-07777 

PIP 10000-17777 

INIT 20000-27777 

TS8 30000-37777 

TS8II 40000-47777 

although the third section is referred to as INIT, it is actually 
"ade up of several programs, including the TSS/8 initializer, a 
--■^bugging routine (XDDT) , and a disk patch routine (DISKLCOK) . To 
^a^ch the system, it is necessary to bring these routines into 
-ore. To do so, stop the systcsm and then start it at 4200. INIT 



is brought in and prints LOAD, DUMP, START, ETC??, 
the layout of core and disk is as follows: 



At this poini 



Highest 
Core Field 



Field 1 
Field 




Core Storage 



SWAP and FILE J 
AREA 



TS8II 



TS8 



INIT 



FIP 



SI 



DISK STORAGE 

Starting at 4200 always brings INIT (plus XDET and DISKLOOK] into 
the highest core field in the system. Thus, it comes into differer, 
fields for different systems. 

There are now two options for patching the system: either patch t>. 
disk using an overlay tape created with an assembler such as PALD, 
or manually inspect and change individual words using DISKLOOK. 

3.2.1 Patching Edusystem 50 Monitor with an Overlay Tape. The 
overlay tape is created by writing and assembling a PALD program. 
The first item on the tape should be a field setting for the track 
number where the patch is to be made. The second item is an 
origin for the desired address within the field. Then include the 
data for the words to be altered. For example, to change woirds 
6 and 7 of SI and FIP to 6213 and 5407, use the following program: 



FIELD 

♦ 6 

6213;5407 
FIELD I 

♦ 6 

621315407 
S 



/PATCK TO SI 

/START AT LOCATION 6 

/DATA FOR LOCATIONS 6 AND 7 

/PATCK TO FIP 



Assemble using PALD, and punch out .the binary tape 
may find this patch helpful.) 



(XDDT users 



Load the overlay tape into the paper tape reader. In response 
to INIT's "LOAD, DUMP, START, ETC??" message answer OVERLAY or 
simply J. When the tape has been read, the patching is finishec 
If there was a checksum error, a message "TAPE RHVD ERROR" will 
printed. The data previous to the most recent field setting wil 
have been written on the disk and thus may be incorrect.' > 
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X 2*2 Patching Edusystem 50 Using DISKLOOK - When INIT comes in. 
It prints ][iOAD, DUMP, START, ETC??. To start the patching proce- 
dure, type PATCH, or simply P. 

rjTCKLOOK is now running, allowing the user to examine and modify 
gingle disk registers. To examine a register, type its address (in 
actal) followed by a colon, DISKLOOK prints the present content of 
•►\at register on the disk and waits for a new value to be typed. 
n-iter the new value by typing 1 to 4 octal digits. Type the RETURN 
^1-r to close the line- If a register has been opened but does not 
rj-'ed changing, type the RETURN key. To automatically open the next 
f"."^uential register, type the LINE FEED key instead of RCTURN. 
vi"^'ernl>er that disk locations are actually 7~digit addresses. For 
^-CcTole, location 2104 in TS8 is stored in disk location 32104. 
T^cation 10 in FIP is 10010, etc. 

ir^en all desired patches are made, type CRTL/C to return to INIT. 

^ji example of the usage of DISKLOOK: 

LOAD* DUMP* START* ETC? P 

i|S>306J 5317 7604 
-^6)100« 663 7 K»20 
AQ)2l2t 6441 6051 
40220: 6451 6061 

(CTRL/C typed by 
LOAD* DUMP* ST/^T* ETC? 

location 2306 in TS8II is changed from a JMP to a LAS. This 
' -^^anae allows the system manager to examine selected Monitor regist 
• hv entering a:! address in the switches. If this patch is made, 
i f^^r pro'gremis may not use EAE Instructions. The pointer in locatic 

6100 of SI is Changed to point to an error return. This patch 
.^>^gj)j3^5-th^ TALK Command. Finally, locations 0212 and 0220 of 
•^'*3II are chajiged. This patch changes the device code of a termina 
I^QHi 44* 4-' to 05, 06. (Note the exact locations may differ in 
^uture Monito.rs. These examples are for illustrations only.) 

' •'>1 changes t(5 Monitor are made on the disk. Starting the system 
b'^^ngs TS8 an(J TS8II into core from the disk, SI and FIP are 
rvapoed in by the system as needed, and INIT reads itself from the 
'*isk^hsfore i- does any important operation. Therefore, any patche 

' ri?Xi become effective at the next startup and remain until the syst 
is rebuilt.- 

/v,ce patched, the system should, of course, be dumped to DECtape 
J^ preserve the patches. Systems without EECtape must be repatched 
l,j/r/ time they are built. 

' ■: 7 CONTROLLING MONITOR EXECUTION 

>-~ve XDDT p3:og:ram, which is always in core with INIT, is very 
iseful for te;5ting any modifications to Monitor. 



INIT (with XDDT) is in the highest field, start the system. The 
highest field will not be used by the Monitor, and XDDT will 
remain there. 

Another alternative for getting XDDT into core is to initialize th(; 
system, and answer "YES" to the question about loading EXEC DDT. 
The result will be that when the system is started, XDDT will be 
placed into field 1 in an area normally used for free core. If 
EXEC DDT is loaded, the Monitor capacity will be restricted 
considerably, but otherwise will not be affected. 

Once Edusystem 50 is up with XDDT in core, the system must be halt^ 
to start XDDT. Press the HALT key. If the EyiA=0 and the MA=5200, 
fine. If not, press CONT and try again. Never attempt to halt 
the system if any I/O is in progress. Once the system has been 
halted at 5200 (this is the null job), restart the system at 700o | 
in the field of XDDT. XDDT may now be used to examine registers, . 
set a breakpoint, etc. Information on the operation of XDDT is i 
available from DECUS, order number 8-127. To restart the Monitor ] 
■after being halted at 5200, start at 4201. (:<DDT, type 0#4201 ' ) . i 

Type CTRL/C to return to INIT from XDDT. 
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CEP.PTER 4 
LOAD, DUMP, START, ETC. USING INIT 

Ij HOW TO OBTAIN INIT 

riiT is the program which allows the user to load, dump or start the 
'vGtem- Whenev(5r "LOAD, DUMP, START, ETC?" appears, INIT is avail- 
':':le. CTRL/C may be typed at any time to return to the entry point 
l'^ INIT. 

-n start INIT if it is already in core, start at 4200 of the field 
*;.3j-e INIT is located. INIT can be found at various times in 
fi^ld 0, field 2, and the top field of the system. 

J; the Monitor is running, start at 4200 of field 0. TS8 includes 
3 ;}ootstrap starting at 4200 to read in INIT from track 2 of the 
2isk to the highest field on the system, and transfer control to it. 
r^ the Monitor is on the disk, and the system has an EDU bootstrap, 
^It the SR to 5 350 and press and raise the SW switch. 

*f the Monitor is on the disk and there is no EDU bootstrap, load 
I'^Q following i:ito field 0, then start the computer at 7750. 

Address Contents 

7750 7600 

7751 6603 

7752 6622 

7753 5352 

7754 5752 

jf ^jie above measures fail, use the rim or binary loader to load 
lie paper tape of INIT. 

INIT OPTIONS 

CRTL/C restart INIT 

Build TSS/8 from paper tapes. 

J, Transfer 4K sections between the system disk and core. 

Dump the system disk to DECtape. 

r Bootstrap to a DECtape on unit 0. 

1 Initialize TSS/8 parameters. 
- Bootstrap to RK8E unit 0. 

l^ Load the system disk from DECtape. 

4^ Compare the contents of two core fields. 
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I', at any time, a drive is not ready, INIT waits for it. Just 
; 'i'-t the drive when ready, and the tape will start. At the end 
'-; each tape, the tcipe will automatically rewind and unload. 
i:: ;:;r;'e the tape, label it with the unit niombers, and save. 

,:,4 LOADING THE SYSTEM FROM DECTAPE 

?!*: any time, the system may be restored to the state when the dump 
t-: BECtape occurred. To do this, mount the dump tapes on the same 
Uita they were 0:1 for the dump, get INIT, and specify L for Load. 

^,cj INITIALIZING THE SYSTEM 

tci change any of the parameters (except for passwords), defined 
at system build time, get INIT, and specify I for INITIALIZE. One 
j.>v now enter a new LOGIN message, change the number of user fields, 
e*:» ^P°^ ^^^ question "WRITE ZERO SYSTEM DIRECTORY?" answer no, 
^«'all of the files on the disk will be destroyed. If the LOGIN 
iiJ^ssage is the only parameter to be changed, a CTRL/C may be 
t'rred after the ALTMODE. The following is an example. 

LOAD* DUMP* START* ETC? I 

NEW LOGIN MESSAGE? Y t^ 

END WITH ALTMODE 

THIS IS THE LOGIN MESSAGE!$ 

LOAD EXEC DDT AT START-UP? N »^ -;< f {>- 

# USER FIELDS -26 ■s'AK--BfiMr^- 
ENABLE tS FEATURE? if y Y ^"" ^■^-7 
60 HERTZ POWER? Y ^ 

WRITE ZERO SYSTEM DIRECTORY? N 

4.6 USING TAPE READ OR WRITE 

^, selected number of disk tracks may be loaded from or dumped to 
".'ECtape. To do this, get INIT, and specify T for TAPE. Specify 
i"-^*>iier to read the tape (load the disk) or write the tape (dump) , 
,»^/«"how many tracks are desired (in octal) . The following is an 

eX'3-T.pl6« 

LOAD* DUMP* START* ETC? T 

TAPE READ OR ^ffilTE - R 

* - 5 

4.7 USING THE 4K DISK-CORE TRANSFER 

% c^lected core field may be read from or written to the disk, 
^o"or from any core field. To do this, get INIT and specify 
r --Jhen specify whether to read or to write the disk, the fiela 
^•'-r^er, and track number (in octal) . Type CRTL/C to terminate 
rhis routine. Tlie following is an example. 

LOAD* DUMP* START* ETC? C 

READ OR WRITE - R 
FIELD NUMBER - 3 
TRACK NUMBER - 5 



4.8 READING A BINARY TAPE 

INIT contains a modified binary loader beginning at 7777 of th' 
field where INIT is. INIT's binary loader automatically choose' 
low-speed or high-speed paper tape reader. If the device read. 
responding, the loader times out in a few seconds, giving an 
error message. This is not a problem unless the tape is loadii. 
into the same field as INIT. If there is an error condition, t 
results will be unpredictable. 

A binary tape may also be read by getting INIT, and specifying 
(Where n is the number of the field to which the tape is to be 
read) . If a field setting for field n is encountered it will ; 
ignored. If any other field setting is encountered, the procc 
willhalt with that field in the AC. Press CONTinue to ignore 
For those using a PDP-8/E, set the data field as desired and p 
CONTinue. 

4.9 ZEROING A FIELD 

To write a zero in every location in a field, get INIT, and tyj 
Zn, where n is the field number to be zeroed. 

4.10 COMPARING FIELDS 

To compare the contents of any two fields, get INIT and specity 
for Match. Then enter the two fields desired and the address t 
start at. Any differences between the two fields will be print 
along with the address. 

The printing may be interrupted by typing CTRL/C. The printing 
occur on the line printer if present and ready, or else on the" 
terminal. If SRO is on, any mismatch with a zero on the first 
field specified will be ignored. Type CTRL/C to halt printing. 
The following is an example.. 

ETC? M 



LOAD* 


DUMP* START* 


FIELD 


NUMBER - 


FIELD 


NUMBER - 2 


START 


AT - 


0000 


5401 0072 


0001 


4200 5402 


0005 


0477 0444 


044S 


0473 8477 



4.11 DUMPING CORE 

To dump the contents of core in octal, get INIT, specify W, and 
then give the desired field and starting address. Each , line print. 
wiii conrain a core address and eight data words, A dump may be 
interrupted by typing CTRL /C, IThe dump goes to a line printer 
-Lz present: and ready, or else to the terminal. The following is a: 
example. 
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LOAD* r:ii;,':..^^ fsTAHT* ktc? w 

STAFrr AT - 



5ii0l 4200 0033 0033 0124 0477 0033 0124 
0010 0007 0010 0011 0012 0013 3553 0215 0016 
0029 0020 0021 0022 0023 0024 0025 0026 8027 

> 17 BOOTSTRAPING TO OTHER DEVICES 

ir^e'i INIT is running, a bootstrap to DECtape or RK05 may be- performed, 
t-' bootstrap to an operating system on an RK05 cartridge, load the 
-';rtridgs on drive zero and type K. 

*»^, bootstrap to a DECtape, mount the tape with unit or 8 selected, 

f:,a type E. 

„, j:eboot INIT, or another operating system which may be on the 
,^!^^em disk, type R. 

. 1"^ USING XDDT UNDER TSS/S 

^■.r-^r-^ INIT is running, type X to jump to location 7000 which is the 
^. linning of XDDT. XDDT is an octal - symbolic debugging program 
."ii-'h preserves the status of the program interrupt system at 
;;_;;">ooints. (XDDT is DECUS order No. 8-527) 

.r''f^ occupies locations 4434 through 7577 of any field. In 
."7n*-ion, symbols may be defined by the user. These symbols will 
,'^^It'^Zir locations 4433 down towards 000, destroying INIT or free 

;^,^^ KDDT sets a breakpoint, it uses locations 6 and 7 of every 
lir-f-'/ field. This may cause problems if an attempt is made to 
5 i>' breakpoint while user programs are running. 

' —r* as described here, has been changed slightly from the 
t\tll^ available from DECUS. See the listing of INIT for these 
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CHAPTER 5 
USING EDUSYSTEM 50 



I lOCGmG IN 

; -rotect the system from unauthorized use, each user must be 
^r.tified by an account number and a password. For example, LOGIN 
^'ciEC is typed if the user's number is 456 and the password is DEC. 
-I WGl^ command is not echoed on the terminal in order to protect 
^ p33S^-^ord. 

> STATES OF THE SYSTEM 

isvborad can be in one of three states: not logged in, SI (or 
f itor) mode, or user mode (not to be confused with the hardware 
>,JrV.oac* T-JM light on PDP~8E) . When the keyboard is not logged in, 
*v Certain commands (such as LOGIN) are effective. When in SI 
>'I t?se system is waiting for a command to be typed. Anything 
^i is considered to be a commiand. A user program may or may not 

jrs the process of running at the time. If a program is not runnir 
* *t5nitor prints a dot to signify it is ready. When in user mode, 
n?:.:ing the user types is placed in a buffer, waiting for his 
4'ra,'!s to ask for it (with- a KFB, maybe). In summary, each charactc 
!J.V^ than CTRL/B and CTRL/c) typed at the keyboard must go to one 
%^ olaces. In user mode, it is saved for the user's program. 

H-nitor mode, it is saved and passed to SI as a command to the 
i iter. 

- ';?ECIAL CHA.RACTERS: RUBOUT, LINE FEED, CTRL/B, CTRL/C 
: CTRL/S AND CTRL/Q 

^^ characters have special immediate action and need not be 
l-'v^d with a carriage return to be effective. 

a 'teyboard is not logged in or is in Monitor (SI) mode, a RUBOUT 
#^-5 the last character typed to be deleted. If the terminal is 
i^^ in the rubbed-out character is printed to help the user make 
i'.'ctions. In user mode, RUBOUT is just another character, which 
X^vrrani may interpret in any way. Most programs delete characters 
%\"-J30UT is typed, usually typing a backslash or backarrow to 
i:LtG this function, 

1 ,1 terminal is in SI mode, a LINE FEED can be typed to cause 
«- orint out the current command line. The procedure is 
Hcularly useful if the user is in the midst of a complex 
nr.d'and has used a number of RUB OUT S . 

,'^ (orinted i^B on terminals) places the keyboard in Monitor 
i 5n5* clears the user's keyboard buffer to make room for a 
p-'d, Tlie rest of the line is given to SI as a command. If 
i-'ser's program is running, it continues to run. (However, if 
-Tcqrarn tries to do terminal I/O, execution is temporarily 
J-ded until the user finishes the command.) 
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CHAPTER 6 
RESTARTING EDUSYSTEM-50 



*-t?!»r 2 details the building procedure for the Monitor. Once this 
w >^Jr*^n done, it is not normally necessary to repeat these procedures 
!!J-*Lns it is desired to start up EduSystem-50. Rather, a procedure 

i'li ' boot str aping" or "booting" is followed. 

^i v*^ are several methods of booting EduSystem-50. The one which 

fnt5St appropriate at any one time depends upon several 
f.7«*3, such as tlie configuration of the computer involved, and 
,'';^*^tQ of the disk and core memories. The first method listed 
^^•v'is the easiest and is appropriate most of the time. The 
'« r«*"0 apply i-'- t^^ system disk is intact, while the following 
■^, '^g'^jjpXy'only if the system has been dumped to DECtape, and this 
-7 is' to he loaded back on to the system disk. If all else fails, 
,,*^vatCT must be rebuilt from paper tapes, as detailed in Chapter 

i I r?5.EUMINARy PROCEDURES 

l.^'^ to using any of the methods listed below, it is necessary to 
'ltZ.sili2& the computer system. If one of the methods is attempted 
i-'it fails* this initialization should be repeated before trying 
*'?!,v^r "method. To initialize the system: Ensure that the power 
^^t'7\P> cowDuter is on, and that the switch is not in the PANEL IjOCK 
r\'f*"cn. *Also make sure that the console terminal is turned on 
?! rri cn-li^® ajid ready. Now press and raise the HALT switch, raise 
JV' «t:iG STEP switch, and press the CLEAR switch. This completes 
!^^'! initialization. 

METHOD 1 

I rf,^ f^Atches and 4, while the others (1, 2, 3, 5, 6, 1, 8, 9, 

*'!"'*„^ 11) should be lowered. Now press the ADDR LOAD, EXTD LOAD, 
IT,---*' and CONT Switches- The console terminal should print ''LOAD, 
v-T-r* START, ETC?" at which time the system may be STARTED. ^ X^^^ 

METHOD 2 



i«^ > * -ethod applies if the systein disk is intact and if the computer 
V « a^-^lB'EG. Method 3 is a substitute for systems without the 
i--r.rr' Users who are not familiar with the MI8-EG may try this 
»*»^f"d' anyway. If method 3 works where this one will not, the 
tLXlr. does not have a MIS-EG. ^_ 

^,<,» switches C, 2, 4, 5, 6, and 8, while switches 1, 3, 7, 9, l,j 
'"#''"« should be down. Press and raise the SW switch. The terminal 
^';.^Z r;rint "LOAD, DUMP, START, ETC?'' at vhich time the sys^c^.- 
■ :: b^ STARTED. 

METHOD 3 
*r.ethod applies whenever the contents of the system disk are 
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-■■■ - - ' -..- ....'7.:.;.on.s siown in the table below. For (■■ 

step in the ziihle, pi.ac^E eccli of the computer switch register swi 
numbered to 11 eith(2r in the up position if the corresponding t; 
entry is a 1 or in the dovm position if the corresponding table e: 
is a 0. When all 12 switches have been set to correspond to a li 
in the table, follow thej instructions in the right hand column anc 
proceed to the next line. 

At the completion of the last step, the console terminal should 
print "LOAD, DUMP, START, ETC?" at which time the system may be 

started. 



Table 6-1 RF08/DF32 Disk Bootstrap 



Step # Octal Switch Register 
Values Setting 







012 


345 


678 


91011 


1 


0000 


000 


000 


000 


000 


2 


7750 


111 


111 


101 


000 


3 


7600 


111 


110 


000 


000 


4 


6603 


110 


110 


000 


oil 


5 


6622 


110 


110 


010 


010 


6 


5352 


101 


Oil 


101 


010 


7 


5752 


101 


111 


101 


010 


Q 


7750 


111 


111 


101 


000 



And Then 



press EXTD ADDR LOAD 

press ADDR LOAD 

lift DEP key 

lift DEP key 

lift DEP key 

lift DEP key 

lift DEP key 

press ADDR LOAD and 

press CLEAR and 

press CONT 



METHOD 4 

Tills method applies when there exists a set of durap tapes which w.. 
dumped previously, which it is desired to load onto the disk. In 
addition, this method makes use of the MI8-EG, and assiomes that tl 
dump tapes have been specially prepared using DTBOOT (see below). 
Method 5 is a substitute for systems without a MI3-EG, and Method 
is used when the dump tapes have not been specially prepared usini 
DTBOOT. , V 

Place dump tape number one on a DECtape drive, write locked. Hov- 
instead of selecting unit 1, place the undt select switch at Di" ^ 

8 . : ' 

Raise switches 3 and 4, while the others (0, 1, 2, 5, 6, 7, 8, 9* , 
10, and 11) should be down. Press and raise the sw switch. The • 
should move for a few seconds, at which time the console should p" 

"LOAD, DUMP, START, ETC?" ,, '^ 

Turn the DECtape unit select switch back to its normal position 0: 
1, and LOAD the system as described in section 4.4. After the ,1^0/';' 
has been accomplished, the system may be STARTED. .; -' 

METHOD 5 ' 

This method applies whenever it is desired to load a set of dump ^ 
tapes to the system disk which have been prepared with the prograr: ^ 
DTBOOT. If the tapes have not been so prcipared, use method 6. ' 
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.. du.Ti? tape number one on a DECtape drive, write locked. HowevGr, 
"^■"'yj'o't selecting unit 1, place the unit select switch at or 8. 

V p,r.xform the switch manipulations shown in the table below. 

'■■ ^'' .^I'Zh Gtep ^-^ ^"^^ table, place each of the computer switch register 

r' v'Cfs niCThered to 11 either in the up position if the correspondinc 
■"'iVntry is a 1, or in the down position if the corresponding 
"*l citry is a C When all 12 switches have been set to correspond 

'■'% lino in the table, follow the instructions in the right hand 

•'^ Wi*«ts^-^ proceed to the next line. 

Table 6-2 TC01/TC08 DECtape Bootstrap 



4i> 



Octal 


Switch 


Register 


And Then 


Values 




Setting 








012 


345 


678 


91011 




0000 


000 


000 


000 


000 


press EXTD ADDR LOAD 


7613 


111 


110 


001 


oil 


press ADDR LOAD 


6774 


110 


111 


111 


100 


lift DEP key 


1222 


001 


010 


010 


010 


lift DEP key 


6766 


110 


111 


110 


110 


lift DEP key 


6771 


110 


111 


111 


001 


lift DEP key 


5216 


101 


010 


001 


110 


lift DEP key 


122.3 


001 


010 


010 


oil 


lift DEP key 


5215 


101 


010 


001 


101 


lift DEP key 


0600 


000 


110 


000 


000 


lift DEP key 


0220 


000 


010 


010 


000 


lift DEP key 


7754 


111 


111 


101 


100 


press ADDR LOAD 


7577 


111 


101 


111 


111 


lift DEP key 


7577 


111 


101 


111 


111 


lift DEP key 


7613 


111 


110 


001 


oil 


press ADDRLOAD and 
press CLEAR and 
press CONT 



^^- the last step above has been performed, the tape should move 
'i I '*i^ seconds,, and then the console terminal should print out 

|.o/o::hp start, etc?" 

,** *he unit select switch on the DECtape back to its normal position 
^ :■ *^^^,4 LOAD the system as described in section 4.4. After the 
•.tVTe'^been accomplished, the system may be STARTED. 



METHOD 6 



i* -***hod is used whenever it is necessary to load DUMPed tapes 
f^A^Ci^T/e not been specially prepared using DTBOOT. 

'x«i** *o chapter two, following the steps for building a new system 
t"' "'he rr.essage "LOAD, DUMP, START, ETC?" appears on the conscle 
]^l\l''\ As soon as this message appears, ret'jrn to the follrvir.g 

-^r-cnse to the question "LOAD, DUMP, START, ETC?" the systeir: may 
'.! "^OADed, as described in section 4.4. After the load has been 

f 



■'■-zlished, the system may be STARTed 



6-3 



METHOD 7 

IVhen all else fails, the system must be rebuilt from scratch, as 

detailed in chapter 2. 

PREPARING TAPES USING DTBOOT 

To specially prepare a set of dump tapes using DTBOOT, take tape 
number 1 of the set of dump tapes, and mount it on a DECtape driv 
However, instead of selecting the no;rmal unit 1, place the unit £ 
switch at or 8. Place the DECtape unit in the WRITE ENABLED 
position. Now, with the EDUsystem-50 monitor in operation, type 
"R DTBOOT" at any logged-in terminal (the program DTBOOT must, 
of course, be stored in the system library prior to this step) . 
all is well, the tape will move (possibly only a fraction of a rt 
and fBS will be printed. The completes the preparation Of the ta 
This preparation is permanent for this tape, and will normally ne 
need to be repeated no matter how many times the system is LOAD 
from or DUMPed to that set of tapes. 

A NOTE FOR OS/8 USERS: 

INIT may be used to advantage when using the system disk for 
running OS/8. Load the paper tape of INIT using standard procedu 
for binary paper tapes, and start it at 24200. Even better, crea 
a SAVE format file of INIT, and simply run it. Wlien INIT asks 

LOAD, DUMP, START, EO^C?" diomp OS/8 to DECtape exactly as if it : 
were E3DU-50. At the completion of the dump, INIT will boot the 
system which is on the system disk, which happens to be OS/8; hen 
another OS/8 monitor dot will be printed. Now, EDU-50 may be los 
At any future time, when it is desired to run OS/8, get back INIT 
and LOAD the OS/8 tapes as if they we^re TSS/8 tapes. At the 
completion of the load, INIT will boot in the system disk, which ! 
contains OS/8 again, and an OS/8 monotor dot will be printed. 
Caution: do not attempt to use DTBOOT on these OS/8 dump tapes, a." 
do not try to boot in these tapes directly. Use INIT. 

NOTE TO VERSION 3 USERS 

The program BOOT may be used to boot EDU-50. When not running of 
of the system disk, typing BO/RF will bring in INIT from the 
system disk. When not running from DECtape, typing BO/DT will br 
in INIT from DECtape \anit 0, provided that it has been specially 
prepared using DTBOOT. 
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CHAPTER 7 
DETAILED MONITOR OPERATION: I 

* ^^ CHAR ING TI ME 

ine most fundamental job of a timesharing Monitor is the sequent 
, ,>j*'^ution (generally for short bursts, or quanta of time) of a number 
-^ 'i5sr programs. This implies that the Monitor has a place availabl 
**A^e a user program can be brought to execute, and a place to put 
f ►!»«• programs when not being run. EduSystem 50 reserves one or more 
. .** fields within the PDP-8 as areas in which to execute user pro- 
,v*a-j3. A user program, and hence a user area, is 4K words long. 
' *;».?'?s*-em 50 may have from 1 to 6 user areas, depending on the amount 
.♦ •*3re available. Similarly, EduSystem 50 reserves a portion of its 
^ , ^2 a place in which to keep programs not being executed. These 
*fi^ areas" are also 4K each. The number of user cores is not 
►ftssarily dependent on the numlDer of simultaneous users; the 
■ :^for simply uses as many as it has available. The number of swap 

'Pit. w* * *■ 

». nn the other hand, is directly related to the number of simul- 
^ .« !i«;ers for which the system is configured. There is one 
.,- 'Abated 4K swap area on the disk for each simultaneous user. 

''ser programs are executed by EduSystem 50 by bringing them into 
..flrtf core from their swap area, executing them, then returning them 
• ^e^'r swap area on the disk, so that the next user program may be 
^^ -s*- in. User' programs may be brought into any available user 

h'lt when they are swapped out, they always return to their 
.*. -r'^d swap area on the disk. 

EduSystem 50 's swapping algorithm may be best illustrated by 
,— -^nq a very simplified situation. EduSystem has a number of 
^rt* orcgrams running within it; each is compute bound, none is 
"f^d in any input/output. Monitor first decides which user to 
^.^^ Tt chooses the user who has waited to run the longest. It 
^.^. .*'^^e3 this user to be brought into the user core. However, it 
J*-, only bring 



7-1 



tnis U3er into a user core which is unoccupied. Therefore, it must 
empty one by swapping its present inhabitant (another user program) 
out. Before doing this, Monitor saves the running state of the pro- 
'aam to be swapped. This information, the AC, PC, LK, and EAE regis- 

ei-s, is stored in Monitor core.' The Monitor then writes the user 
program (whose state is saved) out onto its respective swap area. Now 
the user programi selected to run next may be brought into core. Once 
it is m, its run state is restored (the AC, PC, LK, and EAE registers 
of each user are stored in the Monitor when they stop running) and 
the program is started. This procedure is continued as long as the 
user program needs to run. 

Obviously, the Monitor has to maintain status information about ' 
each user prograjn, whether or not it is in core. Indeed, it must 
maintain more information than just a user program's run state. It 
must maintain all the information it needs in order to decide whether ; 
or not a user program needs to be run. In actual operation, most of 
t^is s atus information deals with the state of a user program's 
input and output. In our simplified case, where no user is doing I/O, 
the -only information that needs to be maintained is whether or not 
the user has finished. If a user program completes its run, the 
Monitor remembers this fact. The program is swapped out and remains 
out. If a program does not complete its run at the time when it must 
be swapped out to allow another user to run, it is remembered to be 
still runnabla. When its turn comes again, this user is swapped in to 
run some more . 





bi ^ 




FILE AREA i 




JOSnSWAP AREA 






USER AREA* 2 


J0a2SV»P AREA 


1^1 


^ 


USER AREA^tt 


JOB t SWAP ARE A 


RESIDENT 
MONITOR 






MONITOR 
IMAOe 
(20K) 

i 



CORE 



0I3K STORAGE 

os-osta 



loK ZduSys-em 50 Configured for n User Programs 
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The process of deciding which user program to run next 
(scheduling) is an important function of the Monitor. The Monitor 
"•'clicallv scans a table which contains the status information for 
,-rfch user prcgram. If the user program being checked by the Monitor 
coes not have to be run (is not runnable) , it is skipped and the 
Monitor goes on to look at the next user program. When it finds a 
user program which needs to be run, it goes through the process of 
gwapping out a user program which has just been run but which is still 
in core, in order to free a core field. It then brings in the user 
program job which was selected to be run, starts it and allows it to 
run for a fixed time quantum. At the end of this time quantum (as 
indicated by a clock interrupt) Monitor goes to the next user program 
to see if it is runnable. When it has looked at all the user programs, 
the Monitor sciheduler returns to look again ac the first job. It then 
continues to cycle through the table of user programs. 

In a system with a single user field, the scheduling algorithm is 
such that some previous user program job must always be swapped out to 
make room for the next. Once a user program is brought in and started, 
there can be no further scheduling activity until it has completed its 
quantum. Similarly, once the user program in core has started to be 
swapped out, the system must wait until the next user program is 
completely sv;apped in before it can do anything. (A user program may 
only be run v/hen it is completely in core.) The only special schedul- 
ing case for a 1-core system comes when only one user program is 
active in the system. User programs are not automatically swapped 
out when they complete a time slice. They are only swapped out when 
another user program must be brought into core to be run. On the other 
hand, when tne scheduler decides that a given user job should be run, 
it does not blindly swap it in. It first checks to see if it is 
already in core. Thus, if only one user program is running, no swap- 
oing occurs. When the program has been run for a quantum, its run 
state is saved but it is not swapped out. The scheduler scans 
through the table of user programs; looking for one to run. Since no 
other program needs to be run, it gets right back to the program just 
run as the proper one to run next., Finding this program still in core, 
the schedule-'r simply restores its state and restarts it. Thus, except 
for these periodic checks, the lone user job runs continuously. 

The scheduling gets more complicated, and rrore efficient when 
there is more than one user core available. The scheduler maintains. 
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in addition to its table of all user jobs, a table of all user jobs 
which are in user core. (A job may be in core, on the disk, or half- 
way between when it is being swapped.) It actually scans the former 
T.able to decide which to swap next and the latter table to determine 
what to do in the meantime (while it is waiting for the swap to be 
completed). The swapping, once set up, happens asynchronously with 
respect to the scheduling. Once it has set up the svap. Monitor always 
goes to its table of in-core programs looking for one on which to 
work. When a user program is scheduled to be swapped out, it disap- 
pears from the list of in-core programs. Eventually, the next program 
scheduled to be swapped in will be read into core. It then appears 
m the table of in-core programs and is subsequently run. ; 

In the case of a system with two user fields (16X system) the 
table of in-core programs has two entries. Entry one indicates which,. 
if any, user program is in field 2; entry two indicates which is in 
field 3. In actual operation, there will seldom be u£;er programs in 
both core fields at once. In a 2-user-field system (again assuming 
our case of several running, compute-bound user programs) one field 
will always be swapping while a progreim is running in the other. This 
IS because the quantum of time in which a user program is allowed to 
run is (roughly) equal to the time it takes to do a swap (a write 
followed by a read). This is explained in the following paragraphs. 

A user program which has just been run is scheduled to be swapped 
out. In the table of in-core programs, it is marked as no longer in 
core. The scheduler then determines if there is anything in core to 
be run. The only candidate is the other user core. If the timing is 
right, a user program will just have finished being swapped in. ■ 
Scheduler then sets up and runs it. (Note that if this swap is not 
completed until after the second swap was started, the Monitor must 
wait for it to be made. This situation would occur if a transient 
error delayed the swap. On the other hand, if latencies on the disk ■ 
were minimal, the swap might be completed b<2fore the other program 
completed its run quanta. In general, however, these two events will 
be almost simultaneous.) At this point, a user program has been 
started at about the same time another is to be swapped out. At the, 
end of its run quanta, the swap should.be complete and a new program 
in and ready to run. 
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Thus, at any given time, one of the user cores is being swapped 
vhile a user program is being run in the other. The data-break 
capability of the PDP-8 allows these two operations to occur simulta- 
neously. Cycles are stolen from the running program to allow trans- 
fers to occur in the other field. There is (in theory) no time lapse 
between the running of user programs. The next one is always ready 
at the time the user program being run finishes its time slice. 
Ofling the standard time slice of 200 milliseconds, this allows five 
users a second to be run. 

This situation is in strong contrast to the situation with a 
aingle-user core. Again^ assuming a 200-milli3econd time slice, only 
half as many users may t?e run in the same time. This is because the 
system cannot run one user while swapping another. During the 200 
aillisecond swap time, the system must simply wait for the swap to be 
completed. In the 1-user core system, swaps and runs alternate; in 
a 2-user core system, they are siir-ultaneous. It is a foreground- 
background operation. 

The scheduler depends on various interrupts to continue this 
process. Specifically, the scheduling is driven by the clock and disk 
completion interrupts. After every successful swap and after every 
100 milliseconds the scheduler is run. If the scheduler is run 
because of a clock interrupt, it checks to see if this is the second 
such clock interrupt it has encountered since it started to run the 
presently-running user program. If not, then this user program has 
not had its full quantum of runtime. It is therefore restarted. 
When the second scheduler clock call occurs, indicating that the user 
program has run for a full 200 milliseconds, it is marked as having 
been run. The scheduler then looks through its table of in-core user 
programs until it finds one to run. If no other programs are in core, 
it sees if a swap is in progress,, If a swap is being made, the 
scheduler knows that eventually a new user program will be in core. 
It returns and runs the same program. Eventually, the program being 
swapped will be in core and run. Even if there is another program 
in core, the scheduler checks to see if a swap is in progress. If it 
is, the scheduler simply starts and runs the next resident user 
program. 

V^hene'.'er the scheduler finds there is nc swapping, it checks to 
see i-f a swap is necessary. A swap is necessary if a user program is 
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on disk which needs to be run. Thus, when the sciheduler finds no 
swapping taking place, it checks its table of user programs to find a 
runnable, swapped-out user program. If it does, it schedules this 
program to be swapped in. (Generally, this meanr. swapping out another 
user's program.) Once the scheduler has set up the swap (if one is 
required) it finds the next resident user program and starts it. 
(Note: the check for swapping activity actually occurs every 100 
milliseconds to assure that the swapping rate is maintained.) 

A swap is scheduled by putting a swap request in the disk queue. 
If the disk is active at the time the swap is scheduled, the transfer 
is not initiated immediately. However, if the disk is inactive, the 
transfer is initiated (by setting up and executing a DMAR or DMAW) 
immediately. Either way, the user program to be swapped is removed 
from the table of in-corc users. It is considered no longer to be in 
core ac the time it is scheduled to be swapped, evsn though it may 
not actually be written out until sometime later. 

Every time the disk completion interrupt occurs, a check is made 
to see if there are any requests pending in the disk queue. If there 
are, the next is started immediately. If the disk transfer just 
completed was a swap-in, which means that a new user program is now 
in core, the table of in-core programs is updated to reflect the new 
arrival. 

Thus, scheduling consists of two asj/'nchronous processes. Disk 
handlers, running off the interrupt, are continually swapping users in 
and out of core areas. As they do this, they update a table which 
indicates which user programs are in user cores. These routines work 
on a queue of disk requests. As soon as a transfer is complete, as 
indicated by a disk completion flag, the disk routines immediately 
e-tart the next transfer on the queue. While the disk handlers are 
processing the requests on the disk queue, other scheduler routines 
are deciding what swaps, if any, to do next. Once they have made 
that decision and queued the appropriate disk request, they scan the 
table of in-core user programs in order to select the next user pro- 
gram to be run. This table is updated by the disk-swap handling part 
of che scheduler. Thus, a user program which the scheduler selects to 
be swapped in will eventually be swapped into a core and hence appear 
m the table of in-core user programs. The scheduler, scanning this 
table for a resident job to run, will find and run it. 
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T'c is important to system efficiency that, at the time the sched- 
uler cjoes to the table of in-core user programs to find one to run, it 
finds one. If it does not, it schedules a non-job, the "null job," 
\.:> be x\:-.. This null job is run until a valid user program is in 
core. {The null job is a tight loop in Monitor core which increments 
the acc\imuleitor . It does not occupy a user core. It is not swapped.) 
Clearly, in a 1-user core configuration, the system spends a great 
deal of time in the null job. From the time a swap is initiated 
until it is completed, the Monitor can do nothing but run null job. 
In a 2-user core system, the effeciency is much greater. The back- 
ground swapping assures that a new user program will be in core at 
about the t:Lme the currently active program completes its time slice. 
More than t\/o user cores virtually assure that time will not be wasted 
running the null job. 

The previous discussion of scheduling is based on some radically 
simplified .assumptions. We assumed a steady number of compute-only 
jobs. With a more normal mix of programs, scheduling becomes much 
mere complex; user programs are being continually started and programs 
are being continually started and halted. Those that are running may 
need to be interrupted for input/output. All this increases the 
complexity of the scheduling. How these additional complexities are 
handled is discussed later in this manual. 

7.2 SOME DEFINITIONS 

In the preceding discussion/ we have referred to the programs 
running in EduSystem 50 as "user programs". In fact, in the system 
documentation, they are referred to as "jobs". Job, in this sense, 
means something slightly different than user program. It also mear.s 
something different than "job" as it is used in batch processing syster- 

A job in EduSystem 50 is the capacity, or capability, to run a 
program. A user, when he logs in, is assigned a job. He keeps this 
job, which has an associated numtjer, until he logs out. A 16-user 
system is thus a 16-job system. At startup, it has a pool of 16 avail- 
able jobs which it assigns to individual uSers as they log in. Once 
it has assigned all its available jobs, the Monitor cannot accept 
more users until one logs out and releases his job. 

The distinction between a job and a user program is clearest 
rignt after logging in. The ^ust-logged m user nas a joo. He aas 
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been assigned a terminal with which to intercommunicate, and a 4K swap 
track in which to store his program. However, as yet he has no user 
program. In short, the job is not the frogreim, it is the capability 

zn run a program. 

Once logged in, users are known to the system only by their job 
numbers. The Monitor simply schedules aid runs jobs. The job numbers 
for a 16-user system are 1 through 16. The null job is assigned job 
number zero. Users who are trying to log in are assigned job numbers 
(since a job number is required internally even to get through the 
LOGIN procedure). If the LOGIN is successful, the user retains the 
]ob number; if it is not, it is forgotten. 

The Monitor maintains a table, JOBTEL, which indicates the status 
of each job. It has a 1-word entry for each possible job. If the 
job IS unassigned, this word is zeroed. While the job is defined, its 
word in JOBTBL contains a pointer to the complete status information 
for this 30b. The Monitor also maintains a table of in-core jobs. 
This table is called COBTBL. ][t is made up of a 1-word entry for 
each available user core. Each entry contains the job number (and 
some other status bits) of the job which occupies that particular core. 
Finally, there is a single register, JOB, which indicates which job is 
being run at a given moment. JOB is updated at the end of a job time 
slice, CORTBL is updated with each swap, JOBTBL is updated on log-in 
and log-out. 

7 . 3 TALKING TO THE USER PROGRA .M 

The preceding discussion is limited to compute-bound jobs, those 
that do neither input nor output. This situation is rare. Most user 
jobs do a great deal of console I/O. For i:he Monitor to process this 
console I/O, it must solve a number of immediate problems. First, 
It must be able to handle multiple consoleti. All EduSystem 50 con- 
figurations have multi-terminal hardware, allowing the system to input 
characters from any given console and outpvt them to any console. 
However, it must also determine which console is which, and which 
characters ar-? received from which console. User programs on EduSystem 
50 are regular PDP-8 programs; as such they input characters from the 
console and output them to the console. There is no ambiguity in a 
stand-alone system that has only one console. In EduSystem 50, where 
many ;jobs are outputting to the console, the potential for confusion 
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is considerable. The EduSystem 50 Monitor must maintain a table 
listing which console is used by what jobs. Thus, when a job does 
console T/0, Monitor knows the individual console involved. 

These are the immediate problems the Monitor must solve. However, 
to be useful, it must also be efficient. Normally, a PDP-8 program 
doing I/O spends virtually all its time waiting for the device; it is 
the monitor's responsibility to recover this time and use it to run 
another job. Finally, the Monitor should smooth the I/O. EduSystem 50 
is a swapping system? user programs are in core only for short periods, 
then they are swapped out to the disk. If a user program could only 
output when it is in core, its typeout would be sporadic. Input would 
be worse. If a user program could only input when the job happened 
CO be in c^re, no input would be done. 

This problem of smoothing I/O is solved by maintaining buffers 
(lithin the Monitor. There is a terminal input buffer and an output 
buffei' for each job in the Monitor. On input, as characters are 
received from the console, they are put into the console input buffer 
for the joD associated with that console. Thus, the program to 
receive these characters need not be in core. The same is true of 
output. Ciaracters taken from a job's console output buffer are sent 
to the user's terminal whether or not the associated job is in core. 

This console character handler may be thought of as the asynchro- 
nous part (asynchronous in the sense that it happens independently 
of the running of individual user programs). Each user's input and 
output buffers are being filled and emptied (by Monitor) whether or 
not the user's program is in core. It is essentially an overhead 
fxxnction. A little processor time is taken from whatever program is 
currently running and used to keep up the I/O for all active users. 

This interrupt driven terminal handler solves the problem of 
chuttling characters between console and buffers. There remains the 
problem of passing characters between these buffers and actual user 
programs. This character passing occurs via the EduSystem 50 hardware 
trapping capability. On input, the key instruction is KRB, the 
keyboard-read lOT. A user progreuxi, when it inputs a character, 
executes this KRB. The hardware modification causes a trap to Monitor, 
preventing hardware execution of the instruction. On identifying the 
traoped ICT as a KRB, the Monitor gets a character from the input 
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buffer which corresponds to this job, puts it in the accumulator, and 
returns to the user program at the instruction following the KRB. 
The user procrram never knows that the KRB was simulated. It acts 
-■•■actJv 's it does on a stand-alone PDP-8. The same procedure applies 
to output- Execution of a TLS is prevented by the hardware; a trap to 
Monitor occurs instead. Once it has identified the trapped lOT as a 
TLS, Monitor takes whatever is in the accumulator at the time of the 
trap and places it in the appropriate outptit buffer. Once again, the 
lOT has been precisely simulated. (The asynchronous temninal routine 
assures that the characters placed in the output buffer are typed 
eventually. ) . 

However, the ability to sini,ulate KRB c.nd TLS is only half the 
job. There remain all the timing and synchronization problems which 
are normally solved by the skip lOTs : KSF and TSF. In a stand-alone 
PDP-8, KSF means "Is there a character in the input buffer?" In TSS/8, 
the 1-character hardware keyboard buffer is effectively replaced by a 
multicharacter software input buffer. Thus, in EduSystera 50, KSF means 
"Are there any characters in the input buffer?" KSF, being an lOT, 
traps from a user program. The Monitor, upon identifying the trapped 
ICT as a KSF, checks that user's input buffer. If there are any charac- 
ters in it, the Monitor simulates a skip by returning to the instruc- 
t-on : - the user program which is two locations beyond the KSF. 

This' arrangement allows for efficient user program I/O. It 
allows many characters to be passed quickly, between a user program 
and the Monitor. In a stand-alone system, it is impossible to input 
characters at more than 10 cps, the terminal speed. Under TSS/8, 
many KRBs or TLSs may be executed in a hundred milliseconds. For 
example, consider the following sjequence of code: 

LOOP* TAD I AX /AUTO INDEX 
SNA 
HLT 
TLS 
CLA 
JMP LOOP 

Each TLS puts a character in the output buffer (assuming it is 
not full). In this manner, a whole series oJ: characters may be output 
m a few milliseconds. (By output, we mean moved to the output buffer. 
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It may be many seconds before the asynchronous terminal handlers type 
chen^ all. This is, however, of no concern to the user program.) 
Similarly, if there are many characters waiting in the input buffer, 
■ ,oy cooid al] be picked up at the same time by a KRB loop in a user 
program. 

If the timing of these functions can be manipulated favorably, 
t^e system car handle input and output efficiently. The object is to 
separate the character I/O from the vraiting I/O. Rather than wait 1/10 
of a second between each character, output 80 or 90 characters at 
o'^ice, then wait 8 or 9 seconds. .By bundling the I/O wait times into 
usable amounts, like 8 or 9 seconds, the Monitor can use them to run 
otJier jobs. This timing is handled by the scheduler and device 
fiardlers. It is important that the user never hang in a KSF; JMP .-1 
Joo? as on a stand-alone system. This is the code normally used to 
wait until more I/O can be done. On EduSystem 50, the user job cannot 
fce left to waste processor time in this loop. Therefore, when the 
Monitor detects a KSF which is false followed by a JMP.-l (i.e., the 
program must wait for the device), it stops the program just as if the 
time slice had been completely used. The state of the program is 
saved. However, the prograim is stopped in a special way. It is 
narked as not runnable and the reason v/hy it is not runnable (waiting 
for input) is remembered. Since it is not runnable, it is dropped 
frc:n the run queue and, when the scheduler finds it the next time, it 
will not be run. However, the Monitor continues to keep track of the 
state of the I/O. At the time when the device is again available, 
the Monitor changes the state of the job back to runnable. Now the 
^(xxt time the scheduler looks at this job it will run. The job will 
be started where it had stopped (at the skip instruction) but this 
time the skip is true, allowing the program to continue. Thus, by 
trapping the sxip lOT, the Monitor has salvaged the wait time from a 
^ob and used i: to run other jobs. 

In order :o make running user programs even more efficient, the 
Monitor exercises control over the keyboard and teleprinter flags. 
These flags aro part of the status information for each user. The 
object is to turn on the flag, thus starting the user program only 
when it is possible to process many characters. This is done on 
input by setting up a "break mask." This break mask tells the 
Monitor what characters are important delimiters. For example, BASIC 
considers carriiage return and rubout to be delimiters. When BASIC is 
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ready for keyboard input, it executes a KSF to see if there is any. 
Typically, there is none. (The user has not yet begun to type in the 
next line in his program.) Therefore, this user program is put in the 

wd: i: state and is marked as not runnable. It stays in this state 
until £1 delimiter appears. The keyboard flag is then set, the program 
is returned to the runnable state, scheduled, and run. As soon as the 
program starts, it executes KRBs to read input characters. BASIC 
can thus process a whole line of input in a single, 200-millisecond 
time slice. Since this line probably took several seconds to input, 
this user is actually using very little system time. The same situation 
applies to output. As the program outputs characters, these charac- 
ters are placed in the output buffer. As Icng as the buffer is not 
filled, the program is allowed to run. However, when the buffer fills, 
the program's teleprinter flag is cleared, thus suspending execution 
of the program (it moves into I/O wait). As characters from this 
buffer are subsequently typed, ending the buffer-full condition, the 
teleprinter flag is held down and the user program is kept in the non- 
runnable state until the buffer is almost emptied. At this point, the 
program is restarted so that it can put more characters into the 
output buffer, keeping a continuovis output. Programs like BASIC can 
fill a character output buffer in one time slice. Therefore, input, 
like output, is accomplished without substantial processor time. 

It is the combination of the two parts of the I/O handlers: 
those driven by lOT traps and operated synchronously with respect to 
the user program, and those driven by device interrupts and operated 
asynchronously with respect to user programs, which accomplish I/O. 
The common, communication areas for these two routines are the console 
input-output buffers, and their associated flags. The problem of 
efficient scheduling is solved by prudent manipulation of these flags. 
This is done on input by means of the delimiter, or break mask. On 
output, :Lt is done by detecting buffer-full and buffer-almost-empty 
conditions. ' . 

The above discussion is somewhat simplified. Actually, programs 
need not use the skip-on-flag instructions at all and may use string 
I/O instructions to transfer many characters at once. 
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CHAPTER 8 
MONITOR: A MORE DETAILED LOOK 



Thus far, we have reviewed some of the operations of the EduSystem 
50 Monitor and how it responds to various simplified situations. This 
chapter discusses these operations in greater detail: the various 
subsystems vithin the Monitor, the full scheduling algorithim, and the 
C&ta base. 

8-1 l>'Oy iTOP. AS INTERRUPT HANDLER 

The fundamental task of the time-sharing system is to run user 
programs, "'ime spent running the Monitor is nonproductive overhead. 
Therefore, the Monitor must restrict its activities to the minimum 
tiTne necessary to keep user jobs flowing smoothly. In order to meet 
this goal of minimal overhead, the EduSystem Monitor is used as an 
interrupt processor only. The Monitor is never run except in response 
to an interrupt. The interrupt trap address in field 0, location 0. is 
its only eni;ry point. It always exits by dismissing the interrupt. 
When it completes the handling of an interrupt, the Monitor dismisses 
back to the user job. The job is allowed to run until the next 
interrupt; this being the only way xn which the Monitor can regain 
control once a user job has been started. Since it is better for 
the system to be always running a job, the interrupt handling tech- 
nigue assurss that the system will be doing that as much as possible. 

Interrupts to the Monitor are divided into three levels: level 0, 
level Ir and level 2. The DC08A clock is the only level interrupt. 
The workings of the clock routines are dependent on the TSS/8 
configuration. In a PT^8 or KL8E system, there is a line frequency 
clock. In a DC08, there is just the DC08 baud clock. This clock 
then serves both as the system clock and the signal to enter the 
DC08 service routines. The Monitor does not take action on every 
clock interrupt. It waits for 100-millisecond intervals (12 ticks of 
a line frequency clock - 55 ticks of a DC^8 clock). Thus, when the 
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clock interrupt occurs, the clock interrupl: handler simply increments 
a counter to see if 100 milliseconds have eilapsed. If not, the inter- 
rupt is dismissed. (On a DC^8 system, the DC08 service routines are 
run to scan the lines for incoming characters and to continue output.) 
Only at 100-millisecond intervals does it involve more Monitor 
processing. In this case, it is treated as a level 2 interrupt. 
DC08A level has its ovm register save area and hence may interrupt 
any other process. 

The level 1 interrupts are the device interrupts: reader, punch, 
disk, DECtape, etc. If the system has PTjSSr. or KL8Es, the console 
terminal interrupts are also level 1. In the case of the paper tape 
reader and punch, the interrupt processing generally consists of trans- 
ferring a character between the device and a Monitor character buffer, 
DECtape and disk error flags are also disposed of immediately; the 
transfer is retried. In all these cases, the interrupt is dismissed 
immediately. 

Since they are all brief, none of the iiiterrupt processors above 
reenable the interrupt system before dismissing. Therefore, they have 
no problems in protecting themselves against being re-interrupted. 
This is not the case with any of the other interrupt processors. 
These "reenable interrupts" which are considered to be level 2 inter- 
rupts, reenable interrupts before they start processing. The level 2 
interrupts may be best characteri::ed as those which take a long time 
to process. The level 2 interrupts consist of the ICFO-milli second 
clock, service for keyboards, teleprinters, rsader, punch, or line 
printer, operation complete for the card reader, disks, or DEGtape, or 
a trapped user JOT interrupt. Level and level 1 interrupt handlers 
take up a miniscule amount of code. Therefore, the Monitor may be 
thought of as a large level 2 interrupt procer.sor. 

Since level 2 interrupts are serviced with the interrupt re- 
enabled, there is the possibility that they themselves may be 
re-interrupted. Level and level 1 interrupts present no problem. 
The level 2 interrupt code does its own register saves (AC, PC, LK, 
and location 0) to assure that interrupts front the other levels do not 
interfere. A second level 2 interrupt, on the other hand, causes 
problems. It makes no sense to suspend the handling of one level 2 
interrupt to go off and start on another. Therefore, the Monitor 
checks for -^nd prevents, this situation. Wherever a level 2 inter- 
rupt is detected, the Monitor checks to see whether it is a user" mode 



program whici is interrupted. (The state of the user mode bit is 
automatically Scived when an interrupt occurs.) If the processor 
was interrupted out of the user mode, indicating that a user program 
usb rui.i-ing at the time of the interrupt, then it is permissible to 
cfocesb che Level 2 interrupt. Monitor proceeds to do so. If, on 
the other hand, the processor interrupted out of exec mode, this means 
the Monitor was in the process of handling level or a previous level 
2 interrupt (the only conditions under which an interrupt out of exec 
mode could occur) . In this case, processing the new level 2 interrupt 
is deferred. It is placed on the level 2 queue. Entries in the level 
2 queue are addresses of the routines to handle the specific inter- 
rupt. Once this is done, the interrupt is dismissed, bac)c to a 
location witiin the Monitor. At the completion of each level 2 
interrupt, the Monitor checks this level 2 queue. If it is empty, it 
dismisses back to the user program. If it is not empty, the Monitor 
IS reentered to process the next request on the queue. Only when the 
backlog on lavel 2 queue is exhausted does an exit occur from the 
Monitor. 

In the case of 100-millisecond clock interrupts, the level 2 
handlers save the whole state of the user job in his job status 
registers. When this interrupt is finally dismissed, the saved state 
of the :iob, with its job number in core register JOB, is restored. If, 
in the meantime, the scheduler has changed the contents of JOB, it is 
in fact a new job which is started. Thus, even the system scheduling 
is accomplisned by means of the interrupt handlers. 

It is i'Tiportant to keep this concept of the Monitor as interrupt 
handler in mind since the system is incomprehensible when viewed in 
any other li^ht. All actions by the Monitor may eventually be traced 
to some interrupt. Swapping occurs in response to a disk completion 
flag. When the disk completion is detected, the Monitor, via a 2-level 
interrupt, looks to see what the next swap should be. When the swap 
is found, ths Monitor initiates it. Scheduling occurs as a response 
to the 100-mLllisecond clock level 2 interrupt. If it is the second 
such interrupt since a user job has been started, the Monitor looks for 
a new job to run. Even in the interim level 2 clock interrupts, the 
Monitor tries to do some advance scheduling. If there is no swapping, 
the Monitor sees if it should begin swapping. Thus, while a job is 
running, the scheduler tries to get the next job ready, so that it 
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may be started immediately after the current job completes its time 
slice. When a job does complete its time slice, the scheduler's 
task is to set up and start the next job. 

Ter.ninal, paper tape, and line printer I/O are handled by special 
level 2 routines. These routines are run every timc! an interrupt from 
one of the devices occurs. In the case of terminal input and the 
paper tape reader, characters are stored in a ring i)uffer at level 1, 
and removed and placed into the appropriate user bu3:fer in free core 
at level 2. In the case of terminal output, the paper tape punch, and 
the line printer, there is a one-word buffer for eac:b device. When a 
device interrupts, a character is removed from this one-word buffer 
(if there is one there) and immediately transmitted. Later, at level 2, 
a character is removed from the appropriate free-core buffer and placed 
into the one-word buffer. Special code allows the ?.ine printer to 
fill its hardware buffer at level 2 with the interrupt system enabled 
and without going through the one-word bviffer. 

All interaction between the jobs and the systen takes place 
through the medium of the lOT traps. The scheduler is heavily 
dependent on the state of each job's input and output. For now, we 
will just look at the lOT trap handling in general, indicating how 
various classes of lOTs are handled. 

Once the Monitor has identified an lOT trap interrupt, it tries 
to identify the IDT that caused the interrupt. At the time of the 
interrupt, the PC, which is stored in location 0, is set at the address 
following the lOT. This pointer is backed up and the lOT is fetched 
from the user's core. This IDT is then tested against a dispatch 
table of all valid lOTs. If the trapped lOT is found, the Monitor 
dispatches to the appropriate routine. If it is no': found, the lOT 
is undefined. Control is returned to the user prog::5un. The lOT is 
treated as a NOP. 

Some valid trapped instructions do not return ro the user program 
at all. HLT is the obvious example. HLT means, quite specifically, 
do not return control to the progralm. Control of this job passes to 
the system. {How all this operates is duscussed in the next section.) 
Some lOTs always cause control to be returned to the user program 
immediately. Among these are all the lOTs such as TOD, USE, etc.. 
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which have nothing to do with the actual input/output. lOTs , as they 
are used by programs running under TSS/8 do not necessarily mean 
instructions used to drive I/O devices. They are actually instructions 
y.ui"^ allow a job to talk to the outside world, whether it be a 
peripheral or just EduSystem 50 Monitor. Those lOTs which communicate 
just with the Monitor return to the user program immediately. 

The lOTs which correspond to the actual devices, such as the 
terminal lOTs, may or may not return to the user program immediately. 
A true .KSF (the keyboard buffer has one or more delimiters in it), 
allows control to be returned inunediately to the user's program (with 
the skip simi-lated) . Similarly, a KR13 which successfully gets a 
character and a TLS which does not fill the output buffer allow 
control to be; returned to the user program. In these cases, the user 
program is able to do more useful rumning. After a true KSF, the 
proqram can do a KRB to pick up the character. After the KRB, it 
can process the character, then look for more input. 

8-2 I/O WAIT CONDITION 

The user program is only allowed to run again after one of these 
lOTs if the program is free to do some useful work. In the opposite 
cases, where the output buffer is fall or the input buffer empty, there 
is no expectcition that the user pro<3ram can continue processing. It 
is an I/O wait state if the user program is looking for input which is 
not there (false KSF or unsuccessful KRB) or trying to output where 
there is no room. On a stand-alone PDP-8, the program goes into a wait 
loop until ii: can do more I/O. Under EdySystem-50 , user programs whicn 
must wait for I/O are not allowed to loop. They are stopped until the 
wait condition has ended. (Note that this prohibits programs from 
overlapping I/O and processing within themselves. Time spent in I/O 
wait is used to run other jobs rather than the job which is in the 
I/O wait. Note also that the wait condition does not occur on a 
character-by -character basis. All I/O is done on a buffer-by-buffer 
basis to allow programs to keep up full I/O rates, even though they 
spend much of their time in I/O wait states.) All other user job 
I/O is handled in a manner analogous to that of the terminal. In 
all cases, buffers of characters are passed between Monitor and user 
programs. The programs enter an I/O wait until Monitor has successfully 
completed the transfer of that buffer. 
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Scheduling is highly dependent on the state of the I/O. Therefore, 
the lOT trap handlers keep a status register (the "wait mask") to indi- 
cate for what I/O device the user progriam is waiting. The mask, which 
corre.-.r ends exactly to the user's status register (STRl) , has a 
dununy bit, the "Job is not waiting" bit that is set when the user 
program is not in an I/O wait. Whenever an lOT trap occurs and the 
user program is to be stopped, the bit corresponding to the device 
for which the program is waiting is set. Thus, if the user program 
executes a KRB when its input buffer is empty, tha bit in the wait 
mask which corresponds to the keyboard flag is set. The user program 
is not restarted and control returns to scheduler so that another user 
program can be run. Thus, whenever a user program is in an I/O wait, 
a single bit in the wait mask indicates tha device for which it is 
waiting. (Some transfers, such as file reads and writes, always place 
the user program into a wait state. Others, like the terminal do so 
only when a buffer fills.) 

'iha scheduler uses the wait mask to decide w!iich jobs to run. 
First, the scheduler keeps a run bit in the job s-atus register for 
each user. A user's run bit is on if there is a prograin in progress. 
The run bit is set when the user starts his progr.un. It remains set 
until the program is halted. Those users whose run bits are not set 
are never scheduled to be run. Among those jobs liaving run bits set, 
only those not in an I/O wait state are actually :5cheduled to run. 

In deciding what user to schedule next, the scheduler scans the 
list of active jobs looking for one with its run bit set. Finding 
such a job, it sees if the wait mask ANDed with the job status flags 
is nonzero, if it is, the job is runnable and is scheduled to be run. 



NOTE 

If the job is not in I/O wait, the chummy 
hit, the "job is not waiting" bit, is set 
to assure that the job will be runnsble. 

If the job is in an I/O wait, the wait mask ?.NDed with the" status 
bits is zero. Only one bit in the wait mask is set - the bit cor- 
responding to the flag for which the job is waiting. This flag is 
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zero at the i;ime the wait mask bit is set (otherwise, the job would 
not be in an I/O wait). In this way, jobs which are in an I/O wait 
are prevented from being scheduled. 

A job breaks out of an I/O wait when the flag corresponding 
to the bit in the wait mask comes oa. For example, assume that a job 
is waiting for the keyboard « Eventually, the user types a delimiter 
on the keyboard. This causes the delimiter bit to be set. The next 
time the 3ch(?duler checks this user's status, the wait mask ANDed with 
the status b.tts will be nonzero. The job is then runnable again. In 
general, fla<js are cleared by lOT trap-handling routines. Clearing 
a flag means a wait condition; at the same time a flag is cleared, 
the corresponding bit in the wait mask is set. Flags are generally 
t^st as a result of level 1 interrupts; i.e., those that do the data 
transfers. They are detected by the level 2 scheduler when it looks 
for thr nexc runnable job. 

This motie of operation characterizes the whole Monitor. The 
Monitor is made up of a number of asynchronous elements which com- 
Runicate via status registers and request queues. The Scheduler, which 
is the heart of the Monitor, is guaranteed to be run every 100 milli- 
seconds. Therefore, it is not necessary for another routine, such as 
the disk handlers, to jxamp directly to the scheduler in order to indi- 
cate that a .jwap is complete. To indicate the new system status, the 
disk routines need only set the appropriate status bits. The next 
time the sch<>duler is run, it finds this updated status and acts 
accordingly. Similarly, if the scheduler decides that a swap is needed 
it may simply queue this request if the disk is active. When the 
completion flag for the present transfer is processed, the disk que':e 
is checked and the queued transfer initiated. However, if there is no 
disk transfer in progress when the scheduler decides to do a swap, it 
cannot just queue the request. In this case, the scheduler itself 
nust initiati? the transfer. 

8 . 3 OT HER P. ^RTS OF MONITOR 

The Monitor code which performs the functions discussed so far is 
oermanently resident in field zero v/hile EduSystam 50 is operating. 
Field zero contains almost all the resident code. The Monitor also 
occupies field one. About IK of field one is used for code, most of 
it for devic<5 handlers. The remainder is for tables and buffers, 
nearly all o: the resident Monitor data base is m field one. 
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In addition, there are two nonresident sections of Monitor code. 
They are the System Interpreter (SI) and the file handlar (FIP) . 
These routines are not frequently used and do not need to be core 
resident. FIP is a 4K block of code which resides in tie second 4K 
block of the disk (disk locations 10000-17777). SI maki2S up a 4K 
block of code which resides at the bottom of the disk (disk locrations 
0-7777) . When needed, these routines are brought into ::ield t\?o for 
execution. They do not overlay the resident Monitor; they go i.nto 
the first user field. In fact, the scheduler sets them up jusi: like 
a user program. They run in the place of the user program which called 
them. For this reason, they are referred to as "Phantoris," 
(FIP = File Phantom). They are not, however, identical to usei: pro- 
grams because they are run in exec mode. This means they may read 
and write physical disk segments (in the case of FIP) ar.d get at field 
and 1 data and subroutines. 

8.4 THE MONITOR DATA BASE 

Some mention has been made of the tables and buffers used by the 
Monitor. Diagrams of the tables and buffers used by the Monitor may 
be found in Appendix D. These should be referred to as specif:. c 
tables are mentioned. A brief discussion of the tables followj;. 



The Monitor does a great deal of dynamic storage assignment. 
It uses a pool of 8-word blocks known as the free list. At system 
startup, the unused area in field 1 is divided into theso 8-wo]:d blocks 
and linked together by a list structure. 

A location in field 0, called FREE, contains a "pointer" to the 
first unused block of free core. A pointer is simply the. address of 
the first word in the block. The first word of this block coni:ain3 a 
pointer to the next block, etc., to the end. When a routine n<»ed3 
some place to store data, it can remove a block from free core, 
adjust the list accordingly, use the block, and later return it. 
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As blocks are removed from and replaced back into free core, a 
count is retained of free core size. This is in location FRECNT. 
FRECNT always contains the number of unused 8-word free core blocks. 

Ncte -^hat all free core blocks begin at an address divisible 
by 8; that i.s the last octal digit is a 0. If a frese-core block ever 
seems to start at an address which does not have the; last digit 0, 
the system :.s in trouble. 

This fi-ee core is used by the Monitor for a variety of purposes. 
Terminal bu^'fers are made up of linked blocks of free core; device 
and job stai:us information are also stored in the free core. Free 
core is also used in a number of instances for temporary scratch 
storage. 

The device handlers for terminals and the assignable devices 
niake extensive use of free core. Both are based on a single, fixed- 
length tabli? of devices, DEVTBL. DEVTBL contains a 1-word entry 
for each system device (a console counts as two devices: keyboard 
and telepri iter) . If the device is unused, the entry is zero. If 
the device is active, the entry contains a pointer to a block of free 
core known as the Device Data Block (DDB) . This bJ.ock contains the 
status information for that device. In addition, there is a buffer 
for each device. For most devices, the buffers are dynamically 
allocated from free core. As characters are entered from the 
keyboard and put in the buffers they are put into (3-word blocks of 
free core. As one block fills, another is fetched from free core and 
linked to it. As characters are fetched from the ouffer and passed 
to the user program (via trapped KIlBs) , blocks at the other end of 
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the buffer are emptied and returned to free core. Withi;i the DDB 
are pointers to the head of the buffer (the "fill pointer" which 
indicates where the next character is to be put into the buffer) and 
tie tail of the buffer (the "empty pointer", which indicates the next 
character to be pulled out of the buffer) . Input buffers and output 
buffers work in the same way. 

Thus, console input and output operate independently from the 
rest of the system. As characters are entered, theiy are put into 
input buffers (up to about 90 characters) . If the character is one 
designated as a delimiter, the user's keyboard status bit is set. As 
characters appear in the output buffer, they are typed. Buffers 
expand and shrink to meet the needs of the moment. This is the limit 
of the responsibility of the terminal handler. The terminal handler 
merely passes characters and adjusts the appropriate flags. 

Just as each active console is marked in DEVTB.j, eacli active job 
is marked with a job status table, JOBTBL, which is a fixed table with 
a 1-word entry for each possible system job. Non-existeni: jobs are 
marked by zero entries. Existing jobs have an entry which is a 
pointer to an assigned free-core block which is its first job status 
block. Each job actually has several blocks of status information 
linked together; these status blocks contain all information about 
this job's running state. If there are open files, blocks exist 
which contain their status. 

Finally, there are tables the Monitor keeps whi::h. indicate the 
status of the system. CORTBL, which indicates where jobs are in user 
cores, is the most important of these. 
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CHAPTER 9 
SYSTEM STORAGE AND COMMUNICATION 

^.l T ALKING TO THE USER 

Until now,, we have assumed that jobs running in the system 
f Cher did no I/O or simply did console I/O. In doing this console 
r^ characters were passed in a manner analogous to a stand-alone 
f'-n-Q, No mention was made of how the program was started in the 
, — <5t place, much less hov/ it was loaded and otherwise controlled. 
/..-•se are functions which, on a stand-alone machine, are not per- 
' ^T.ed through the terminal at all — they are done through the 
\^,^^(^QS on the console. When talking to EduSystem 50, however, 
, ./jre is only one physical device, the user's terminal, through 
^••ich to pearform these two kinds of communication: communicating 
. ith EduSystem 50 and communicating with a user program running as 
^ ^ob within that system. 

EduSystem 50 makes a careful distinction between these two 
j-^des. A user is always uniquely in one mode or the other, depend ii 
.■>n the state of his job. Whenever a user starts executing a program 
h.^s console is put in program communication mode. It stays in that 
„^j5e until the program is interrupted or terminated. If the progra 
;$ terminated, the console automatically returns to system communi- 
-ation mode. It is also possible to make one-shot inputs to the 
c"stem without halting the user program. 

In order to minimize confusion, EduSys'.tem 50 has some conven- 
tions to distinguish between system and user mode. The system alwc 
*'jr^es a period at the margin to indicate that a terminal is in syst 
rede and that the system is ready to accept a new command. The 
r-'RL/B character tells the system that regardless of the mode of tl 
terminal, the characters following the CTRL/B are to be treated as 
-hough the terminal were in system mode. Thus, even if the termin. 
^5 in user program mode, all characters following a CTRL/B up to t 
^ext carriage return, are input to the system. 
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When the user walks up to an EduSystem 50 console, he finds it in 
system mode. If the user types a carriage return, thereby .,ent;ering a 
null command, EduSystem 50 responds with a period at the margin. The 
'i-,rr -.-^n then typo a command to the system. At this point, tY.e ter- 
.vinol ; :-> act-ually in a special system mode -- it is logged out. This 
means 

a) Input is not echoed to the terminal, and 

b) Only selected commands, such as LOGIN, TIME, and VEFSION, 
are considered valid. 

To the system all other commands are illegal. Thus, the first 
thing a user does is type a LOGIN command, which consists of the 
command LOGIN followed by an account number and a passwi^rd. If the 
account number and a password are valid, the user is logged in. The 
terminal remains in the system mode, but input is now duplexed and 
all system commands are now valid. (If the login is in^'alid, the 
user must try again.) 

The user remains in the system mode then types a ccmmand vhich 
causes a program to be started. This is done by means of the START 
command which takes an octal address as an argument. (i^. program 
can also be started with an R or RUN command.) The STAFT command , 
starts the program and puts the terminal in user program mode. 

Cnce a program has been started, there are two ways to stop it, 
thereby returning the console to system communication mode. Oie 
way is for the program to execute a HLT. The other way is to type 
an S (for STOP) command to the system. However, since the terminal 
is in user program mode, it is necessary to preface this S by a CTRL/B 
in order to get the attention of the system. Notice that by typing 
CTRL/B while a program is running, many commands may be 'Entered to the 
system. Only S, .however, will send the terminal back to system mode. 
With the other commands, the program continues to run and hence the 
terminal returns to user program mode. 

So far only three Monitor commands have been discus jied: START, 
STOP, and LOGIN. There are, however, many more. (They are deiscribed 
in Appendix B. ) 

The set of commands enumerated in Appendix B is designed to give 
the user convenient and comprehensive control over programs. The user 
can do debugging tasks with commands such as EXAMINE and DEPOSIT; 
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store and rv.tr XQve programs with cotninands such as SA\'E, LOAD, and 
RUN; and control additional peripherals with command:3 such as 
ASSIGN and RELEASE, etc. 

The handling of all these system commands is accomplished by 
means of a nonresident system phantom called the System Interpreter. 
si's task i:3 to scan and interpret system input strings and either 
execute them directly or reduce thorn to a concise ceded form to be 
executed by another part of the EduSystem 50 Monitoi'. SI is called 
by the terminal handlers (part of resident Monitor) whenever a system 
command (of::en referred to in the documentation as an SI string) is 
input. 

Characters being input to the System Interpreter are handled by 
the terTTiinal input routines exactly the same way as characters being 
input to a aser program. In either case they are placed in the 
Multicharacter texTninal input buffer until a delimiter is detected. 
(Delimiters for SI strings are CR, LF, vertical tat, form feed, and 
rubout if the buffer is empty.) It is only when the delimiter is seen 
that the two types of input strings are treated dil:ferently . In the 
one case, the characters are passed to the user program; in the other 
they are passed to SI. 

A bit in the input Device Data Block, the "rojte characters to 
SI" bit, is used to remember that an input string is actually an SI 
string. This bit is always set v>hen the terminal is in SI mode. 
It is also set whenever a CTRL/B is input. A comirand to start running 
a user procrcun clears the bit. 

If the "route characters to SI" bit is set, input characters are 
checked agcdnst the System Interpreter delimiter mask (carriage return, 
VT, FF line; feed, and rubout). If the input character is a delimiter, 
a second DE)B bit, the "SI command delimited" bit, is set. Also, a 
scheduler register, COMCNT, is incremented. 

COMCNT, at any given instant, reflects the number of users who 
have typed in a whole command to the system and are waiting for a 
response. The scheduler checks COMCNT every time; it runs. As long as 
COMCNT is ;:ero, everything is up to date. However, if COMCNT >0, this 
means that someone has an SI string waiting. In this case, the System 
Interpreter is scheduled to be swapped in and run. It is brought into 
field two and started up just as any other user program. The principa: 
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difference is that SI, being a system phantom, is run in v.xec mo(3e. 
This means it can execute lOTs without trapping back to field zero. 
Specifically, it may do a CDF into the Monitor core in order to inspect 
DDBt. When it finds an "SI command delimited" bit set, SI knows what 

called ic. 

Once it has found what called it, SI reads the command string to 
find the basic command. SI has a dispatch table for all valid 
commands. For commands which take arguments, the string is scanned 
to pick them up. If an error is detected anywhere along the lin(i, SI 
exits back to the Monitor after typing an error message back to the 
user. If the command is valid, SI must decide what to do with il:. 
SI is capable of executing many commands on its own. For the rest, 
it calls for help. For all file operations, it must call still 
another nonresident subsystem, the File Phantom, For thesa commands, 
31 reduce- the input string to a concise command code whiciT is then 
passed on to the appropriate portion of the Monitor. 

SI itself is essentially reentrant. It gets its inpu:, the 
command string, from the Monitor core. SI operates on it, and puts 
any output, either a response string to the teleprinter or a concise 
command to be executed by some other part of the system, back into 
Monitor core. SI may be thought of as the English language intejrface 
between the user and the system. It allows the user to enter 
commands in a simple format. These input strings are transilated by 
SI into a form that the rest of the system can understand. It resides 
on the disk and is called in to perform this interpretation and 
translation function whenever a user requires it. 

9 . 2 DISK STORAGE AND FILES 

Up to now, the EduSystem 50 disk has been mentioned orly as a 
swapping device. For each job, there is a dedicated 4K area on the 
disk in which the job is stored when it is swapped out. This is not, 
however, the only way in which the disk is used. The low-order tracks 
of the first disk are used to hold an image of the system. 0-7777 con- 
tains the System Interpreter Phantom. 10000-17777 contains the I'ile 
Phantom, part of which is tables and part of which is code. The entire 
4K of FIP is brought in whenever it is called. If FIP updates any of 
its tables, these are written back out to their place within the disk 
imaae. SI, which contains no internal tables, is never written back 
after it is called. The next 4K of the disk contains an image of the 
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system initializer. It is brought in only at system startup time, it 
is not used while the system is up. It is kept on the disk to allow 
for easy system restarts. The next 8K is used to hold an image of 
the s. :: iCiaut Monitor. It is brought into fields zero and one by 
the initializer at system startup time. It is not accessed by the 
running system. Like thQ image of INIT, it is kept on the disk to 
allow rapid recovery from crashejj. 

The area of the disk immediately above the system image is used 
for th€i swap areas. There is 4K for each possible system job. (A 
16 user system thus uses 64K of the disk for swap tracks. This, plus 
the 20K cf system image, totals 84K of disk which is taken for 
system usage. ) 

All remaining space on the disk is devoted to on-line file 
storage. If the system has more than one disk, t!ie additional 
surfaces eire completely devoted to file storage. The file area is 
allocated in 256-word segments. 

EduSystem 50 provides users and user prograirs with the capability 
of setting up files in this area of the disk and of reading and writing 
them. Th(ise files may be of arbitrary size; they are, however, 
made up of an integral nximber of disk segments. Creating a file 
reserves a segment of file space on the disk and associates with it 
the symbolic name specified in the create commancl. The user may open 
this file, thereby allowing it to be manipulated, He may extend the 
file a given number of segments, thereby reserving more segments of 
the disk for the file. Extending a file puts th<i new segments on t^;e 
"end" of the already allocated segments. Reducing a file returns on(i 
or more segments from those reserved for this file to the pool of 
available segments. The user may also rename a file. These four 
basic functions of creating, extending, renaming and reducing (deleting 
is accomplished by reducing a file until there is nothing left) have 
nothing to do with the contents of the file. They merely define and 
reserve a certain amount of space on the disk. 

As far as the user is concerned, these segments are contiguous. 
He addresses, and therefore manipulates, the fi;.e as though it were 
one big long disk area. The actual size of the file, as determined 
by creat€;s, extends, and reduces, is important (Dnly in that a user 
cannot write off the end of the file. 
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The file itself is considered to be made up of 12-bit data words. 
There are no control words in the file; all the space v«ithin a file 
which a user has defined is available for program storage. The user 
adJre:--2s a file by internal file number and an address withir, that 
file. The first word of the file has address zero. Using this file 
address, the user may transfer data between a selected part of the 4K' 
core and the addressed point in the file. Although only 4K meiy be 
transferred between core and a file in one transfer, the size of files 
S.S by no means limited tc 4K; JL8 bits are ailocatsS fcr iiisk iiiJLs 

zjGtween typas of tilas. All files ara niade; up of 12-bit data words. 
Whether these 12-bit words contain single ASCII characters (or, indeed* 
characters of any other code), pairs of trimmed characters, numbers, 
or whatever, is immaterial to the system. How the data of a given 
file is interpreted by a program is, of course, what matters. 

That segments of a file appear to the user to be contiguous is 
an illusion- Disk segments are, in fact, allocated at random. Edu- 
System 50 maintains directories in order to remember the segments 
allocated to certain files. As mentioned above, the actual segments 
which make up a disk file are pure data axea. Segments cf a file are 
not chained together; there are no header words attached to a segment. 

For each user, EduSystem 50 maintains a User File Directory (UFD) 
that holds the names of all files a given user is maintaining and the 
disk segments of which it is comprised, 

NOTE 

The diagrams at the end of this manual 
will help in understanding the EduSystem 
50 file structure. 

The UFD is divided into 8-word entries. For each file there is 
a single filename entry. The first three words contain the filename 
(6 characters packed in EduSystem 50 internal format). 

Words 4-6 contain information about this file. Word 3 contains 
a pointer to the next name block in this user's UFD. This pointer is 
used to chain through the UFD name blocks. The final word of i:he 
name block (Word 7) contains a pointer to a File Retrieval Information 
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Block. Eac:h name block has associated with it one or more of these 
retrieval Idocks. They are also 8-word blocks and are interspersed 
with the ncime blocks in the UFD file (hence the need to chain the 
name hi.o<k;.). The first word of the retrieval block is a pointer to 
the next rtstrieval block for this file (or zero if this is the final 
block). The next seven words contain a list of setjment numbers of the 
segments which comprise the file. The file is comsidered to run from 
the first segment in the file to the last. (A zero segment number 
terminates the list.) The algorithm for associating addresses within 
a file (th<j means by which a user addresses hir file) and physical disk 
addresses (the system's ways of addressing) is straightforward. The 
file address is divided by the segment size. The quotient is the 
logical file segment number. Counting down tht: file retrieval block's 
list of segment numbers to this number yields 'he physical segment 
number. (If the list runs out too soon, the u:>er has run off the end 
of hir file.) 

In the actual implementation, the UFDs are files. They are made 
up of disk segments just like any other file. (The 8-word blocks 
into which the UFDs are divided are merely a software division.) In 
order to keep track of these UFD files, there is still another 
directory, the Master File Directory. In format, it is virtually 
identical to a UFD. It is broken down into 8-worc" name and retrieval 
information blocks. The 3-word names in the name block are, however, 
login IDs rather than filenames. The first word c:ontains the accoun*- 
number as a 12-bit binary number, the next two woids contain the 
4-character password, packed in internal code. Tciken altogether, 
these three words constitute the "name" of the UFO. (The I'lFO Is, of 
course, aJso used at login to see if the account number and password 
are valid.) The file retrieval information block linked to the nair-e 
block (in the case of the MFD, only one retri'^.vai block pe-r UFO is 
allowed) c;ontains the numbers of the segments which make up the UFD 
for the U5;er. 

To complete the symmetry, the MFD is in turn a disk file made u^p 
of segmen':s. It, however, always starts with segnient 1. 

The MFD and UFDs take care of the problen of ailccated disk 
segments. There is one further table, the Strrage Allocation Table 
(SAT), which keeps track of unallocated segme:.t3. SAT is a bit table 
which is set up when the system is initializer!. It contains a bit 
for each segment . . . the bit is cleared if the corresponding segren*- 
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IS available, it is set if that segment is allocated. All requests 
for disk segments get the segments from the SAT table rouzines. Simi- 
larly, no longer needed segments are returned to the SAT. For example, 
if a f ' le is to be extended a segment, the SAT routines are called. 
They L\.turn with the number of an available segment, whici is added to 
the list of segments in the retrieval blocks for that fila. Files are 
reduced by deleting the last segment number or numbers fram the list 
and clearing the corresponding bit(s) in the £;AT table. 

9.3 TALKING TO THE DISK: THE FILE PHANTOM 

Most of the tasks described in Section 9.2 are accomplished by 
a second nonresident section of Monitor, the File Phantom (FIP) , FIP 
handles all disk manipulations except actual reads and writes. Like 
the System Interpreter, it resides on the disk. It is called ty the 
Monitor to perform functions v/hich cannot be handled by residert 
routines. All tables relating to the disk files are kept within the 
4K which FIP occupies. They are swapped in with FIP whenever it is 
called. Whenever they are updated, the tables are immediately 
written back to the disk by FIP. In this way, the disk always 
contains all information about itself. The disk is thus protected 
against loss in most system crashes. 

FIP's primary task is to do the file handling. It maintains the 
UFDs, the MFD, and the SAT, performs all the needed searches of. 
these tables, and executes the basic file commands of CRIJVTE, ISXTEND, 
REDUCE, and RENAME as discussed above. These all happen indep<;ndently 
of the resident Monitor; they result in changing the status of the 
disk only. PROTECT is similar; it allows the protection code on a 
file to be altered, but nothing more. OPEN and CLOSE, however, are 
somewhat different in nature. 

OPEN and CLOSE do not alter the disk in any way, th<2y simply 
establish a link between the resident Monitor and a disk file. (It 
is important that OPEN and CLOSE do not affect the disk. Newly- 
created files exist even if they have not yet been close i out.) Each 
job may have up to four files open simultaneously, Thera are four 
registers in the last job status block which record the status of these 
four internal files. If there is no file open on an intarnal file 
number, its corresponding job status block word is zero. (See diagrams 
of job status blocks. Figure D-8.) When a file OPEN com-nand is given, 
?T? sets up a new ifila control block in free core. This block is 
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used to hold pertinent infoinnation about the open file. A pointer to 
this file control block which remains set up as long as the file is 
open, is placed in the job status block register for this internal 
file. At the sax^e time, FIP sets up a second block j.n free core for 
this file.. This block, the file window, contains one of the file 
retrieval inl-ormation blocks from the UFD. At the t:.me of the OPEN, 
the first fij.e retrieval information block is put in the window. At 
the same timej, the fact that this is the first window is recorded in 
a register or the file control block. Once all this is done, the 
OPEN is complete. CLOSE merely dismantles all this .and zeroes the 
register in the last job status block which corresponds to this open 
file. Opening a file automatically closes any file which was open 
on that inteirnal file at the time. 

CREATE is the only file command that does not have to be preceded 
by an OPEN. All other file commands operate on internal file numbers 
rather than filenames. In the case of EXTEND, REDUCE, and PROTECT, 
this is to allow for file protection. The file protection apparatus 
is part of tie OPEN routines. Files which are read-protected against 
a user cannot be opened by him. If a user is allowed to read but not 
write, he is allowed to open a file but a write-protected bit is set 
in his file control block in free core. EXTEND and REDUCE are consi- 
dered to be the same as writing. They are prohibited if write-protect 
is indicated. The PROTECT command,, which sets these various modes of 
protection, is illegal except for the file owner. Finally, there is 
an implied protect on files open to more than one user. If a file to 
be opened is already open to another user, it is wri te-protected to 
prevent confusion. 

RFILE and WFILE, the file read and write commands, require the 
file to be open, because they need the information :.n the open file 
information blocks. RFILES and WFILES do not, in general, require 
FIP to be called. The Resident Monitor attempts to execute them 
itself. It takes the file address given as a parameter to the 
command and compares it against the state of that file's window. It 
sees if the segments in the window correspond to the part of the file 
involved. If so, it executes the transfer. (Note, that if it is a 
write, the write-protect bit in the file control block block is 
checked first.) If the window is not properly set, the resident 
Monitor calls FIP to move the window so that it is looking at the 
specified part of the file. FIP then returns to the Monitor so that 
it can do the transfer. 
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FIP is called whenever the Monitor discovers a request that it 
cannot handle. Before calling, it must set up the appropriate 
command and parameters so that FIP will know what to do. This command 
is alwciys in the form of an lOT; one of the EduSystem 50 lOTs. If 
parameters are involved, they are passed in precisely the format that 
they are specified for the lOT itself. Thus;, CREATE takes three words 
of parcimeters, OPEN 5, etc. 

Whatever the lOT, the lOT and all its parameters are placed in 
block of free>.t:ore A pointer to this block is placed in the job status 
block register referred to as JOBLNK. FIP is then called. If FIP is 
to return parameters, it does so in this sane block. As soon as the 
block is no longer needed, it is returned to free core. Some lOTs do 
not take parameters. The AC is the only paiameter. In this case, no 
lOT Parameter Block is needed. The lOT gees; into JOBLNK. (The AC is, 
of course, stored in another job status block.) If JOBLNK is less than 
400, it contains an lOT with the first 4 bits stripped off. If 
JOFiLf^K 13 400 or greater, it contains the address of a free-core block 
which contains the IDT, 

FIP maintains the Storage Address Table (SAT) which is located 
in the high end of FIPs 4K. Whenever the SAT is changed (a segment is 
allocated or deallocated), it is written back to the disk so that the 
next time FIP is brought in, an \ipdated version of the SAT will come 
in with it. The SAT is the only permanent t.fible that FIP maintains. 
It is never changed by a system restart. (Ir.itializing, of course, 
clears the SAT.) All other tables and data areas maintained within 
FIP are kept only as long as individual users are logged in. They 
are cleared on a system restart. 

FIP handles all the open-file information liriked into job status 
blocks. These are set up on an OPEN, clear^sd out on a CLOSE, and 
suitably updated whenever a file is changed. FIP also maintains some 
internal tables which make its operation more effi.cient. For example, 
when a user logs in, FIP opens that user's UFD. It gets the retrieval 
information block from the MFD and stores it in a table. By doing 
this, FIP does not have to scan the I4FD every time it wants to find a 
UFD. FIP also remembers how many users are logged in under this 
account number or are using a file belonging to tlie account. 

Finally, FIP does all updating of the directories, the UFD and 
UFDs. It has a 256-word buffer into which it can read directory 
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segments. Fill? scein;3 directories by reading them in one segment at a 
time until the desired entry ia found. If it is changed, this segment 
is then writiien back out to the disk. If the directory is extended or 
reduced, FIP updates the appropriate retrieval information block in 
the MFD. 

See Appendix D for a more detailed discussion of the FIP tables. 

9.4 DISK. TR^^NSFERS 

All dis]c transfers, whether they are swaps, user program I/O 
requests, or FIP table or directory transfers, are handled by a common 
disk routine. Most disk transfers go between user fields; resident 
Monitor never does transfers into field 0, and only the DECtape handler 
requests transfers in field 1. Th<2 common disk routine takes a 
standard set of parameters which are stored in a block of free core. 
They are: direction of the transfer, the field invoJ.ved, the disk 
address (physical), the core address, the number of words to be 
transferred, and the address of the routine to go to when the transfer 
has been completed. The disk routine sets up the transfer, does it 
and then dispatches. If it tries three times and f.ails, it dispatches 
to an error handler instead. 

Since requests to do disk transfers can pile up, there needs to 
be some place to queue them. . In the case of swaps, there is a single 
register Sl'/PEQ. If it is zero, no swap is pending. If it is nonzero, 
it points tc a parameter block for the next swap, in or out. Swaps 
get first priority. When the current transfer is done, this swap 
will be done next. 

All other transfer requests are held in DSUTBL (often referred 
to as the disk queue). DSUTBL has a 4-word entry for each core field. 
A nonzero ertry indicates that a transfer is pending for that core 
field. (The; entry points to the parameter block.) Within the 4-word 
entry, each word corresponds to an open file. Thu.3, if the job in 
field 3 wishes to read open file 2, it executes an RFILE. The 
resident Monitor uses the retrieval window for that file (calling FIP 
to move it, if necessary) to figure out the physical disk address. It 
then builds a parameter block in free core, and puts a pointer to it 
in the third word of the DSUTBL entry for field 3. The program is 
then put into the wait state until the transfer is complete. It is, 
however, prtivented from being swapped while this transfer is taking 
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place. This is done by setting the LOCK bit in CORTEL to lock the user 
into core. This bit is cleared when the transfer is completi^d. (Disk 
transfers on the system disk- and the RK05, and card reader transfers, 
\;hich are not buffered in Monitor core, require that the pro<jrain 
remain in core.) Even FIP, when doing directory transfers in and out 
of its own area, or writing out its internal tables, ises th« DSUTBL 
for queueing requests, 

9.5 ASSIGNABLE DICVICES 

All EduSystern 50 systems include a high-speed paper tap€! reader. 
Some may include optional devices, such as a high-speed punchi and 
DECtape. These de:;vices comprise the assignable devices for the sys- 
tem. They may be used exclusively by individual on-li;ie users. 

Assignable device handling breaks down into three sections: 
assigning and releasing the devices, a device handler, and code to 
pass data betv/een the Monitor buffers and the user program. Assignable 
devices have their slots in DEVTBL just as the terminals do. If the 
device is not assigned, the corresponding register in DEVTBL contains 
zero. When a user requests a device (and it is available) a Device 
Data Block is set up and linked into DEVTBL, Within ths DDB is 
stored the number of the job which now owns the device. Whensver a 
reference is made to this device, the referencing job in checked 
against the job number to assure that it is the right one. No error 
checking is done at assignment time. Thus, all eight DECtape;3 could 
be assigned even though only two transports exist. When a user 
releases the device again, the DDB is freed and a zero is returned to 
the DEVTBL entry. Also, the amount of time that the device was 
assigned is added to the user's device time. In this wa/, use of 
assignable devices is reflected in the accounting infomiLition., 

Different assignable devices use different methods of buffering 
tneir I/O. For example, the paper tape reader, which uses a J:ree- 
core buffer, is activated by a RRB lOT. Finding the buffer empty, the 
Monitor puts the user job into an I/O wait state. This clears its 
reader flag and sets the corresponding bit in the wait mask. It then 
sets up the reader service routine to read characters into th€i reader 
buffer. When tlie buffer has been nearly filled, the user's reader 
flag is reset, making the program runnabXe again. The program then 
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executes successive RRB lOTs to pick up individual characters. When 
tiie buffer empties again, the process repeats. The user may clear 
the buffer by ext>cuting an RGB instruct:lon - 

Operation of the high-speed punch is very similar. The running 
program passes characters to the Monitor, via trapped PLS instructions. 
These go into the punch buffer. If the buffer fills, the job goes 
into the wait state until it is emptied again. One difference is than 
punching is be<jun vhQnev&c any chntncAAxn «r«* ir* tr?^ '>uKfy,^ ,.,ft^t> 
rhe •ionitor dcx;s .'ict v«i,^: fox tt.^ rrAf^.r to f;i. . -y>., *, ^ ,,,.. , .-,,., 

rrt- fir_ Tr.^ ixn* px^c.Z4,t l» K*;i.di<*d ift a ;nann4r «^i,n,..^r ^o -r;- ^ i-rv 
speed punch. 

DECtape handling is different. DDEs are set up when they are 
assigned and returned when released. Since there are .igv... :>c..lbl. 
tiCtapes, tne ^.nx^or res-erves eight words in r.KV'n.L. r.. «.,.^ r.f,^. 
ere used for reads and writes. Since the DECtap., controJ].,r .J iow« 
access to only one transport «t « tim«, th^ro i« m. ^.o,„» 1,, h.,.;ir,., 
a Monitor buffer fDr oach on*j. In JJaot, f>,«r« u ,,u\ f ,„,„, ,..,,,.,.,-.„ 
of the number of uaits. At th« ti<»i« ti \%%**t vt***ntmH / *. j-»*i.»t *. m 
transfer, the Monitor starts the desired tranuport toward r.h« 
requested block, and the job is put into a wait state. When the block 
is almost at hand, the Monitor assigna the DECtape buffer to th/it 
job, stopping the tape to wait for the buffer if necessary. On a rciad, 
the selected block is now read into the buffer, and transferred to 
the user, either by transferring to his core field or by writing it to 
his swap track on the disk. Conversely, on a write, the tlock is 
moved from the user's core or from his swap track to the CECtape 
buffer, and then vritten to the tape. 

The RK05 and card reader are similar in that they both lock the 
user into core and transfer directly to/from his buffer. 

Although i::he«e are the only peripheral devices supported by the 
EduSystem 50 Monitor, they provide a good model for users who may wish to 
incorporate their own special devices. In all cases, three software 
modules are invol\'ed: one to handle device assignment, one to handle 
data transfers between the user program and the Monitor, and one to do 
the actual device handling. Space in the Monitor is available but 
not in large quanl:ities- 
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9.6 ERROR HANDLIN G 

The EduSystem 50 Monitor allows the user program a great deal of 
. reedod. m the way it utilizes system resources. Therefore, isystem 
error checking is kept to a minimum. A user may have a job do anything 
that does not affect another job, or the system as a whole. l?or exeun- 
ple, a program may wipe itself out without interference from the system. 

The first level of error handling comes when a user program 
requests the Monitor to do something it cannot do, for excunple, opening 
a file that does not exist, or reading from an internal file number for 
which no file is open. For all such logical errors, the Monitor 
returns an error code to the user program. (For more information, 
see Appendix B.) Not all of these errors are simple 

logic problems. For example, trying to create or extend a file when 
the disk is full returns an error. Running the same program some 
other .-.ime would give no error. Another non-logic error is tae parity 
error or directory error on a file read or write. This is tha result 
of physical malfunction of the disk, a transfer error occurred either 
within the file itself or within one of the Monitor's directories. 

The second level of error handling also comes when a user program 
requests something which the Monitor cannot do. For exc.mple, the user 
program requests service from the high-speed reader when somepne else 
owns it, or when it is assigned properly, but there is no tape in it. 
Another example is a physical disk error when trying to swap this job in 
or out. In these cases, it is impossible for these jobs to continue. 
Therefore, the Monitor terminates them, and types out ar. error message 
and the state of the active registers. User programs may, however, 
request that they be allowed to handle such problems, lliey do this 
by executing an SEA lOT, which gives the Monitor an address to JMS to 
when such an error occurs. This routine ia responsible for finding 
out what the error was (the error code is in job status word 1 where 
it may be fetched by a CKS lOT) , and responding to it. The user must 
clear the error status via a CLS lOT. 

The Monitor also does internal error checking which is rot 
apparent to the user. All disk transfers are tried three times. Only 
after the third try is a disk transfer error actually reported. All 
I/O devices except the system disk have a timer. Each time a,n I/O 
operation is started, the timer is set for a number of seconcls, 
iependin^' upon che device. If an interrupt does not occur bcsfore the 



9-14 



timer times out, the Monitor will signal a hung device. In the case 
of a terminal printer, the output buffer is simply cleared. All other 
devices report a system error when hung. 

When the punch or line printer hangs, the Monitor reports the 
error and attempts to re-report it every five seconds until either 
the device is put on line, or the device is released. In the first 
case, output continues, and in the second, the buffer is cleared. 
If SI is called to report a hung device, it will repoit it only once. 
If SI continues to be called every 5 seconds, it will simply ring the 
terminal bell, trying to get the user to do something. 



9-15 



APPENDIX A 
UTILITY PROGRAMS 



The following programs are used conunonly in EduSystem 50. The 
information given here is meant to be only a quick summar" of their 
use. For more information, refer to Users Guide. 



A.l BASIC 

Type R BASIC to execute BASIC. BASIC asks "NEW OR OLD?." 
Arswer CUD to execute a program stored on disk. BAS]:c asks for the 

name of the program. Respond with the name if the program is stored 
under your account number. If the progr£un is stored under account 2, 
respond with the name immediately followed by an asterisk. Optionally, 
follow the name with a space and an account number. 

BASIC now responds with "READY." You may now add or change any 
lines simply by typing them, list the program by typing LIST, or run 
it by typing RUN. To interrupt a running program, type a CTRL/C. To 
return to the Monitor from BASIC, type BYE. 

A. 2 CAT 

A user may type R CAT to run CAT, and obtain a listing of disk 
files. 

The system manager, logged in under account 1 niay type R CAT to 
run CAT and obtain a listing of all users, their pasiswords, amount of 
time used, f;tc. The accTimulated time may be reset by answering "YES" 
to the question "RESET?", 

The system manager may type a R CAT:L to get a disk directory of 
any user. CAT asks the account number of the directory it is 
requested to list. 
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Any user may type R CAT:S to obtain a short SYSTAT. 

The system manager may type R CAT:R to reset all users' CPU 

rime . 

A. 3 LOADER 

The LOADER loads BIN format files into core from disk. For input, 
type the name(s) of the input file(s), separated by comrnas. For 
option, specify D if debugging using ODT is desired. Normally, just 
give a carriage return. The LOADER will not correctly load Locations 
7767 - "7777. If ODT is used, locations 4 an(J 7000 to 
7777 must be reserved for it. 

A. 4 LOGID 

The system manager (account 1) may define, change, and delete 
accounts and passwords at will. S«e Section 6.1, defining accounts 

and passwords. 

A. 5 LOGOUT 

LOGOUT is run in response to the LOGOUT or KJOB Monitor commands. 
See LOGOUT under Monitor commands for additional details, 

A. 6 PIP; PERIPHERAL INTERCHANGE PROGRAM 

PIP moves files between paper tape and disk, deletes disk files, 
or prints them on the line printer, PIP has been replaced by PUTR. 
However, in case some systems desire to use PIP, here are instructions. 

When PIP requests INPUT or OUTPUT, respond with a carriage return 
only, to specify a paper tape reader, paper tape punch, or terminal. 
Respond with a filename for a file under your account. Respond with 
a filename, space, then account number for a file stored under 
someone else's account. 

When PIP requests OPTION, choose from the following list: 

B - Transfer a BASIC program file between the disk, and the 
high-speed reader or punch. The response to INPUT: and 
OUTPUT: indicates the direction of the transfer. 
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D - Delete the file specified for input. 

F - List a BASIC program on the line print;er. 

K - lAsad a save format paper tape from the; terminal. The 

Monitor must be patched to enable thist option to operate 
properly, as it norra«illy forces the peirity bit on for 
terminal input. 

L - Transfer an ASCII file from the disk t:o the line printer. 

P - Punch the contents of a disk file on the high-speed punch. 

R - Read a tape from the high-speed reader and store it as 
a disk file. 

S - Transfer a SAVE torsnat file between the disk and the 

high-speed reader or punch. The response to INPUT: and 
OUTPUT: indicates the direction of thei transfer. 

T - Transfer a file between the disk and the terminal reader 
or punch. The response to INPUT and OUTPUT indicates 
the direction of the transfer. 

A. 7 SYSTAT 

SYSTAT may be run to obtain the status of the system by typing 
SY or SYSTAT. The SYSTAT may be output to the line printer by typing 
S': :tat-l. 

A. 8 PUT R 

PUTR is a program designed to transfer information from any 
EduSystem 50 device to any other EduSystem 50 device, with numerous 
options for different formats. For further details see Users Guide 



A. 9 PTLOAD 

PTLOAD is TSS/8's version of the Binary Loader. To use PTLOAD, 
load a binary tape in the appropriate tape reader, and type 
"R PTLO;!!JD". To "OPTION-", respond with "T" for the terminal (low- 
speed) reader, or "H" or any other letter for the high-speed reader, 
vmen using the low-speed reader, turn it off when the tape reaches 
trailer code. Binary tapes may not be read from a terminal without 
patching the monitor. 
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A. 10 GRIPE 

GRIPE is a program which allows any user to leave a message for 
the system operator,, To initialize GRIPE, log in under account 3 and 
type "R GRIPE". GRIPE should print "THAT'S ALL", and return tc the 
Monitor. The initialization is complete. 

To use GRIPE, any user types "R GRIPE". GRIPE prints "END WITH 
ALTMODE", and then allows the user to type his message, after which 
he should type an AJ^T MODE (sometimes labelled ESCAPE) . 

When the operator desires to read the collected messages, he 
should log in xander account 3 and type "R GRIPE". After the mcissages 
have all been printed, they will be deleted and GRIPE will be I'eady 
to collect more messages. 

GRIPE Stores gripes in an unprotected file under account :i named 
GRIPE ;^rjy user who discovers this can read or destroy thisi file 
if he wishes. 

A. 11 OTHER PROGRAMS INCLUDED IN THE LIBRARY ; 

CATALOG may be LISTed under BASIC for a list of some BASIC 
games and demonstration progreuns . 

PLOT is a FOCAL program to plot a damped sine wave. 

HAMURS is a FOCAL game, as is ROCKES 

HAMURA and ROCKET are saved images of HAMURS and ROCKES which 
are run by simply typing "R HAMURA" or "R ROCKET". 

WDGAME is a FORTRAN demonstration. It may be used as follows: 

.R FORT 

INPUT - WDGAME 

OUTPUT - 

INPUT - DATA 

OUTPUT - 

MATRIX is a FORTRAN demonstration which multiplies 2 square 

matrices . 

TYPE is a PALD demonstration program. When assembled, loaded, 
and started at 400 it prints "0123456789". 
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A. 12 TEST PrHDGm^f^G 

The following progr??r^.G aro vn:;lt±en npecifically to rim under 
EduSystem 50 and to test various capabilitlen of the Monitor. 
These progrcuna can be used as system confidence tests, or 
they may be used by service personnel to exercise peripherals 
without bringing down EduSystem 50. 

A. 12.1 TSTl^IEM 

This is an EduSystem 50 memory diagnostic. If an error is 

detected, the diagnostic prints a message or halts. 

Execution: 

To execute TSTMEM, type "R TSTMEM" . The program prints "11*' 
occasionally to indicate that it is running. Otherwise, the 
program runs until an error occurs, or until it is stopped. 

A- 12. 2 TS'l^DT 

This is an EduSystem 50 DECtape diagnostic which writes and 
reads random data on random blocks in a random direction v;ith 
a random current address. Data and status errors are reported, 
and a status report is available. 

Execution: 

If a line printer is available and on line, type ''R i:^"r.: ::.r "', 
where n is the number of a DECtape drive which has a 
scratch tape mounted on it. The drive should be placed in 
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remote, write enabled. If a line printer is not available, 
type "R TSTDT" , and the diagnostic will ask for the desired 

unit number. 

The diagnostic initially confines itself to the first 200 
blocks on the tape. After a short while, it prints a 
status report, and then begins exercising the entire tape. 

STATUS REPORTS: 

Typing any character other than CTRL/C causes a status report 
to be printed. If the character is an E, the diagnostic wiU 
stop r.fter the status report (the operator may type "START" 
to continue) . The status printed includes the total number 
of blocks read and written, the number of words of data error- 
the number of status errors, and the Inclusive' OR of all 
status bits returned by the Monitor. These status bits 
correspond to TC01/TC08 status register B. 

ERROR REPORTS : 

If a status on data error occurs, the printed information 
will include the DECtape unit number, status A and B for thf; 
transfer, the block number of the transfer, and the buffer 
address. In addition, if there were data errors, a tally 
will be printed, followed by the locations in error .- The : 
first address in the block should be the block number. This 
will be at the high end of the core buffer, if the block was 
read in reverse. The data is printed as it would appear in 
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■0 if the block had been road in t.be f.Qruarcl diiroction, 
„-,2never a read error occurs there is no \fay of ]:nov/in<7 

■/ long ago, or in v/hich direction the block was ^-nritten. 
'£ the user desires to stop a long error report, he types 
jCTRL/C. This halts printing and resumes tesiting. 

^12.3 TSTRK 

>:iis is an EduSystem 50 RK05 diagnostic which writes and 
^eads a random niimber of pages oi: random data beginning 
^t a random core address and a random sector. Data and 
status errors are reported. 

jiKecution: 

^f a line printer is available and is on line, type "R TSTRK:Ln", 

,^here n is the number of a disk drive which has a scratch pack 

rounted on it. The drive should be in the ready position, not 

'^rite-protected. If a line printer is not available, type 

fR TSTRK" and the diagnostic will ask for the desired drive number 

jhe diagnostic exercises the disk until it is stopped. 
After 4096 transfers, it prints a "PASS COMPLETE" message. 
'JO exit from the test, type E, followed by a carriage 
return. If there is a long data error, printing can be 
stopped and testing can be resumed by typing CTRL/C. 
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ERROR REPORTS: 

If an error occurs, the transfer parameters are printed. 
This includes whether the transfer was a read or a write, 
the unit numfc>er, the number of pages in the transfer, 
the RK05 status, the contents of the AC after the DLAG, 
the initial sector, and the begiinning current address. 

The status returned corresponds to the RK05 status register, 
but will be if no error has occurred. The value returned 
in the AC, after the DLAG, should be the number of blocks 
successfully transferred. If the transfer is completed 
normally, this will be (P+l)/2, where P is number of pages 
transferred. 

In addition, if data errors were detected, the information 
printed will include the disk sector number where the error 
occurred, the address within this sector (0-377) and the 
good and bad data. 

A. 12.4 TSTPT 

This is a test of the high-speed paper tap 3 reader and pmic; 
The test punches the special bina;ry count pattern and reads 
either the special binary count pattern, OR A ONES AND ZEROE 
TEST TAPE. 
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■Type "R TSTFvC" . The toc'-:. printn a qni^ck ojotion nummary 
and vraits for a commancU If a P is typsd, the punch begins 
punching. After ci sufficient amount of tape has been punched, 
type P again to stop the punch. 

If an R is typed, the reader starts when the test reads the 
first non-zero frame, it decides which type of tape is in 
the reader, and then it continues. If the user wants to 
stop the reader, he has to type another R. Typing CTRL/C 
causes the* test to halt after releasing the devices. 

ERRORS: 

If the first non-zero frame, on a tape being read, is 
not 001 or 377, tiie test prints a message requesting the 
paper tape. If an error is encountered within the tape, the 
expected and read values are printed. Because of the buffer- 
ing by the Monitor, the physical position of the tape will 
not be close to the frame in error. If a "HUNG DEVICE" 
message is printed, the paper tape punch is probably not 
turned on or is not responding for some reason. This could 
also occur if the reader was turned off. If the reader 
hangs (reads to the end of the tape) , the message "READER 
ASSUMED", may be printed. When a device is hung it is not 
always possible for the test to know whether it was the 
reader or punch which hung. But if it was wrong, the punch 
will hang again in a few seconds. 
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An "ILLEGAL lOT" mcissage probzibly means that another job ovms 
the punch or reader, and it cannot be assigned. The PC does 
not necessarily point to the invalid lOT in question. 

A. 12, 5 TSTLPT 

This is a test of the ability of EduSystem 50 to output to the 
terminal and the line printer. The test will handle 72, 80, 
or 132 column printers or terminals, 64 or 96 characters, and 

four different patterns. 

Execution: 

Type "P TSTLPT", The test prints a quick option summary and 
then waits for a command. If a "T" is typed, the terminal 
begins printing. If a "T" is typed again, the printing stops. 
The same is true of "L", and other commands may take some time 
to take effect. 

Typing a 0, 1, 2, or 3 causes the pattern on the line printer 
or terminal to change. If "T" was typed more recently than "L% 
the terminal pattern will be affected, and conversely, if "L" 
was typed more recently than "T", the line printer pattern , 
will be affected. 

Typing a 9 causes the line printer or the terminal to use 96 
characters. Typing a 6 restores the normal case of 64 character 
This affects "L" or "T" as above. 
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r/ning a 7 causes the line printer or terminal to use 72 
columns; 8 causes the line printer or terminal to use 80 
columns; W (for Wide) causes the line printer or terminal 
to use 132 columns. Again, this affects either "L" or "T" 
as explained above. 

Typing CTRL/C causes the diagnostic to halt and the line printer 
to be released. 

Errors: 

The diagnostic itself detects no errors. Printed output should 
bevisually inspected. If th'e line printer is not on line or 
does not respond, the monitor prints a "HUNG DEVICE" message. 

A. 12. 6 TSTBAS 

This is a test of the ability of EduSystem 50 BASIC to interact 

with a user. 

Execution: 

Type the underlined parts :>f the following dialogue: 

NiiW OR 0LD--01J1 

OLD PROGRAM NAME --TSTBAS*^ 

READY 

HUH— 
At this time, there is a pause for compilation. Then instruc- 
tions for use of the program are printed. To terminate the 

test, do the following: 
'C 

HEADY 

E)YE 
IBS 
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A. 12.7 TSTFOC 

This is an EduSystem 50 FOCAL program which plots a damped 

sine wave on the terininal, testing terminal output. 

Execution: 

To execute TSTFOC, type "R TSTFOC". The program prints an 
asterisk (*) . Type G, followed by a carriage return, 
and the plotting should start. TSTFOC continues until it 

is stopped. 
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APPENDIX B 
MONITOR COMMANDS 



An alphabetical list of all Monitor conroanda is included here to 
make it easy to find any particular one. Some are resitricted, and 
may be used only by someone logged in under account 1 or 3. 

When typing a command, it is not always necessary to type the 
entire word. In fact, each command may be shortened ds long as that 
command does not become ambiguous. For example, EXAMINE may be typed 
instead as EXAMI, EXAM, or even EXA, However, EX or E cannot be used, 
because there is a command nzuned EXTEND, and System Interpreter (SI) 
would not knc^ which one was wanted. 

All numt)ers in SI commands are octal, with two exceptions. 
The word count in the EXAMINE command and disk segmert, counts in 
all cases are in decimal. 

Commands may be concatenated by putting a semicolon between them; 
for example, DEPOSIT 5000; EXA 1; START causes three commands 
to be executed in sequence. Some commands may be entered while a 
program is running. To do this, preface them with a CTRL/B. CTRL/B 
followed by miEEE will allow a user to find out what his program is 
doing without stopping it. 

All commands, terminated by a carriage return, cause SI to be 
read from track into field 2 to interpret the command. Many 
commands require File Phantom (FIP) for processing. SI then causes 
FIP to be read from track 1 into field 2 over SI and executed. When 
FIP is finished, it must cause SI to be read in over FIP to finish 
up. 

Note that the functions of many of these commands may also be 
accomplished by having a program execute a UUO, whicrh often results 
in calling TIP. 
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B.l ASSIGN 

Purpose 

To allow a user to reserve a device. Devices are: 

R - High-speed paper tape reader 

P - High-speed paper tape punch 

L - Line printer 

D - DECtape 

C - Card reader 

K - RK8E 

Example: 

• A Fi 

R ASSIGDJED 

• A D 

D ASSIGNED 

• A D 4 

D ^ ASSIGNED 

Note that one may either request a specific DECtape unit or one 
can request any DECtape unit. The same is true for the RK8E. 
If a specific unit is not requested, an available unit is assi^i 

How? SI calls FIP to complete this command. FIl? checks 
whether the user will get the device and, if so, 
sets up a DDB and puts its address in DEVTBL. 
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D.2 BREAK 
Purpose 

To find or to change the value of the user's break mask. 
;^en in user mode and typing at the keyboard, the user's 
break mask dstermines which characters are significant 
enough to caiise the user program" to restart execution (if 
it is waiting for input) . See lOT 6400-KSB Appendix C 
for details. 

Example: 

•BREAK 41000 

•B=iEAK 
40(30 

First, the break mask is set to 4000. Then its value is 
determined. 

How? The break mask is kept in the third word of the 
keyboard DDB. It is retrieved from there or 
stored there by SI. 
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3 . 3 BROADCAST 

Purpose 

To allow a message to be sent simultaneously to all users. 
May be used only by a user under accomit 1 or 3. 



Example: 



• BROAD THE SYSTEM IS GOING DOWN FOR Pi-i IN 5 MINUTES 
*** THE SYSTEM IS GOING DOWN FOR PM I ^ 5 MINUTES 



OK 
The message is sent to everyone, including the sender. 

licw? The message is simply jammed into all output 
buffers. SI checks to make sure the account 
number of the sender is 1 or 3, If free core 
runs out before the messagei hag been given to 
all terminals, SI returns the error mesEsage 
"BUSY". Otherwise, the message OK is printed. 



B-4 



n.4 CLOSE 
Pu?:p03e 

To inform the Monitor that the user is finished with a file 
See OPEN. 

Example: 

.CLOSE 
More than one unit can be specified at the same time. 



Example: 



•CLOSE I 2 

How? PIP is called to process the command. FIP 
simply undoes everything done by an OPEN 
command. 
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B . 5 CREATE 



Purpose 



To allow the user to create a new file with the length of one 
segment. The file must have a name consisting of 1 to 6 char- 
acters, the first one being a letter. If a file already 
exists by that name, it is first deleted. Under account 1, the 

create command will not delete files (UFD's) nor will it allc 
duplicated account numbers to be created. 

Example : 

•CREATE FILE23 

How? FIP checks for validity of the command, deletes 
any file named FILE23, makes a directory entry 
for FILE23, and reserves one disk se'^ent for 
the file. A protection code of 12 i.3 assigned 
to the new file (see PROTECT) . 
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3.6 DEPOSIT 



Purpose 



To allow the user to change any words in tlie 4K of core at 
will. The uuer gives any address,- and up to ten (decimal) 
values in octal to deposit. 

Example : 

• DEP 10 7001 60/J6 5010 

This deposit:? a simple prograjsi starting at location 0010. 

How? As needed/ SI either stores the values directly 

in the user's core area or writes the information 
to the swap area on the disk. 
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B . 7 DUPLEX 

Purpose 

To put the user's terminal into duplex mode. Normally, 
when a user program is being executed, and the terminal is 
in user mode, characters typed at the keyboard are not 
printed unless the program causes it. Putting the terminal 
in duplex mode causes the Monitor to perforn this function 
automatically. 

Example: 

•DUPLEX 

How? SI sets the duplex bit in the te:rminal keyboard 
DDB. This is bit 4 of 1:he first word of the DDE. 
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B.8 EXAMIN33 

purpose 

ta allow the iiger to ex2unine his 4K of core at will. 
rype the initial address first, and then the number 
of words wanted (in decimal, up to 10) , if greater 
than one. 

[• xample : 



• EXAMINE 10 2 
70(21 6046 
.E:<A 12 
5010 



How? SI either takes the information directly 
from the user's core or, if necessary, 
reads the information from the user's swap 
area. 
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B . 9 EXTEND 

Purpose 

To increase the size of a file. The file must be opemed first 
(see OPEN) . Give the internal file nuinfc>er, and then the number 
of segments (in decimal) . 

Example 

•EXTEN I 10 

This extends the file, which is presently open under internal 
file number 1, by ten segments. The secjments are added to 
-^-he end of the file; any previous contents are unaltered. Any 

files belonging to account 1 (MFD and UFD's) may not be extend' 

How? FIP processes the EXTEND. B'lP reserves the require- 
disk segments by setting bits in SAT, and makes the 
necessary changes in the user's directory. 
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B.IO P 



Purpose 



To get information about a file. The file must first be 
opened (ses OPEN) . 



Example : 



• F I if 

0003 FILE23 00 12 11^ 






This indicates the file currently open under internal 
file nuii±)er 1 belongs to user (or accourit number) 3, 
is named FILE23, has an extension of 0, has a protection 
code of 12 (see PROTECT) , and has a size of 11 segments 
(decimal) . 

How? FIP is called to obtain the needed informa- 
tion, which is then printed by SI. 
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B.ll FORCE 

Purpose 

The FORCE coinmand helps the system manager control the other 
users. If desired, the manager may interrupt or even log out 
a user. The FORCE coinmand allows the system manager or operate: 
(anyone logged in under account 1 or 3) to connect to any other 
terminal long enough to issue a command. For excimple, if the 
user at keyboard 10 has the reader and will not release it, 
the system manager may type: 

•FORCE 10 RELEASE R 

RELEASE R will be printed on the user's console [just as though 
the user had typed it) , emd the reader will be released. 

The FORCE command works exactly like typing on the affected 
console. Commands entered by FORCE are treated cis Monitor coKi' 
niands only if that console is in Monitor mode. The user at a 
console uses the CTR3L/B (echoed fB) to put the console in Moni' 
mode. Within a FORCE command, f is used to indicate that the 
next letter typed is a control character. For example, the 
above command should really be typed: 
•FORCE 10 »BS; RELEASE R 

The uparrow followed by BS (not CTRL/B followed by S) acts just 
like CTRL/B followed by S and assures that whatever the user at 
console 10 is doing is terminated, allowing the release command 
to be executed. In general, when forcing a Monitor command. 
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precede it by an uparrow followed by BS and semicolon, as 
shown above. Terminating the force comraand with a form-feed 
(CTRL/L) will prevent a carriage return from being sent to 
the forced terminal. 

For example, if the user at KIO complains that his terminal 
is completely dead, the operator may discover with SYSTAT 
that he typed a CTRL/S accidentally. To restart this user, 
the operator may type: 

•FORCE 10 tQ 

and terminate the command with CTRL/L (Form Feed) instead 
of a carriage return. Terminating with CTRL/L is also use- 
ful when forcing a CTRL/C to a user. 

When bringing down the system, the following command will 
stop most obstinate users: 

•FORCE 10 tBtBSiKlQ 

Care should be exercised. If there is an error in typing the 
FORCE command, the error message may show up on the forced 
console, and the user will not know what happened. 

How? The forced command is placed into the proper 
keyboard buffer. If the comimand includes an 
uparrow, the next character is changed to a 
control character. 
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B.12 KJOB 
Purpose 

A KJOB is identical to LOGOUT in function. See LOGOUT. 

B . 1 3 LOAD 
Purpose 

The LOAD command allows the user to load the core area with 
data from a disk file. Often, this file is created by a SAVE 
co'Tjnand, and has an extension of .SAV. To use load, type 
(separated by spaces) : 

a) LOAD 

b) The account number the file is under. May be 
omitted if it is the user's own account. 

c) The name of the file. 

d) The address within the file at which to start. 
If omitted, is assumed. 

e) The address in core at which to start. If 
omitted, is assumed. 

f) The address in core at which to stop. May be 
omitted. The transfer will continue until one 
of three things happens: 

1) The end of core is reached 

2) The end of the disk file is reached, or 

3) The core stopping address (if given) is reac' 
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Example£5 : 



•LOAD PIP 
•LOAD 2 SYSTAT 
•LOAD PIP 200 300 400 
•LOAD PIP 200 



The first example reads the file named PIP into the U3er*s 
core, starting at location zero. ' The second example does 
the same task for the program SYSTAT which is stored under 
account 2. The third example reads 201 words from the file 
named PIP into core, starting at file address 2 00 and con- 
tinuing through core address 400 . The fourth example reads 
the file PIP starting at file address 200 and core address C 

How? SI calls FIP to open the file under internal numbei 
3, and then passes a RFIU2 parameter block to the 
file handler in the resident monitor. 
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B,14 LOGIN 

Purpose 

To notify the Monitor that a person wishes to use a terminal/ 
and to give an account number and password. Type LOGIN, 
then a space, the account number, a space, the password, 
and then a carriage return. If the LOGIN command is 
terminated with a line feed, the login message will not be 
printed. 

Note that the command itself is not printed, to protect the 

password. 

How? First, SI checks the command for validity. Then 
FIP is called to set up a number of tables to 
indicate terminal assignments, what time the user 
obtained it, and the user's job number, etc. 
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.15 LOGOUT 



rrpose 



-y indicate to the Monitor that the user is finished and ready to 
;<}ave the term:.nal. Also, LOGOUT gives the user a number of 
-onvenient options. Type LOGOUT:? for an explanation of options, 
^-substitute one of the following for the ?: 

K - to cause the LOGOUT to delete all non-protected filss. 

L - to list the user's disk directories. 

S - to save all non- temporary files, or 

I - to individually determine whether to save or delete 

each of the user's files. Each filename will be printed. 
Type a P if it is desired to protect this file, an S to 
save it as is, or a carriage return only to delete the 
file. 

Q - to logout quickly and quietly. 

'fyping no optr.on causes a logout with the default option, wriich is 
S. 

Sxample: 
LOGOUT 1 1 



-•]?«( .ASC 


<12> 


1* 


BLOCKS 






fORT -SAV 


<12> 


6. 


BLOCKS 




S 


70SL -SAV 


<12> 


6. 


BLOCKS 




S 


•cvp00 


<12> 


1 . 


BLOCKS 




DELETED 


;ILE23 


<12> 


11 . 


BLOCKS 




P 



OB l* USER C 0* 3 3 LOGGED OFF K00 AT 21: 16 139 ON 20 JUL '/Vi 
•SLETED 2 FILES < 2. DISK BLOCKS) 
r^VED 3 FILES C 23. DISK BLOCKS) 

jMTlME 00I00U0 ( 1. CPU UNITS) 
rt^APSED TIME 00106:49 
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B.16 OFF 



L^L'l'' 



When the manager desires to bring down the system for vario'- 
reasons, the OFF command is given. (The manager must be logged! 
under account 1 or 3) . Then, anyone who does a LOGOUT cannot LO^ 
unless the account number is 1, 2, or 3. See ON. The manager c£ 
then broadcast warnings and/or force a LOGOUT. 

Examule: 



OFF 



.w? SI sets- FIDFFJ in field 1 to 7774, allowing only accot^' 
1, 2, Oi. 3 to log in. 

B.17 ON 

Purpose 

The opposite of the OFF command. See OFF. Used by account' 
only. The system is restored to its normal state so that any use- 
may LOGIN. 

Example: ^ 

• ON 
How? SI sets FIOFFJ in field 1 to ZERO, its norrnal value. 
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3.18 OPEN 

Purpose 

Whenever files are manipulated by the user, they are 
identified by "internal file numbers." At any one time, a user 
may have access to up to four files, with internal numbers 
through 3. The open command associates the internal file 
numbers with the actual file on the disk. 

Example : 

•OPEN 1 FILE23 

Assuming that file FILE23 already exists (see CREATE) , 
this statement now allows the file named FILE23 to be referenced 
with the internal file number 1. 

Account 1 may open any user file and not be protected 
regardless of the setting of the files protection word, provided 
the file, is not open to another user. Account 1 files are 
always write protected even against account 1. 

Account 1 has the privilege of deleting any file which is 
not in use merely by opening and reducing the file. For example: 

•OPEN GAMES 14* 3; REDUCE 3000 

will delete the file GAMES which belongs to account 1403. See 
also REDUCE command . 

B.19 PROTEC T 

Purpose 

Each file has a protection code assigned. This ccdr. 
determines who may read or write the file. The protection Wvord 
is stored in the disk directory, and includes the protec r.ion 
code and the filename extension, as follows: 

0123456789 10 11 

Filename Extension Unused Protection Code 

Bit 11, if 1, means that the file cannot be read by users 
whose project number differs from the owner's. 

Bit 10, if 1, means that the file cannot be altered bv users 
whose project number differs from the owner's. 

Bit 9, if 1, means that the file cannor be read by v:..ier3 whc; 
project number is the same as the owner's. 

\/ Bit 8, if 1, means that the file cannot be altered by users 
whose project number is the same as the owner's. 

Bit 7, if 1, means that the user cannot alter his own file, 
without first changing the protection. 
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NOTE 

A user's project nujRb«r la th« first 2 
digit* of the 4-<3igit account nux3b«r. 
The system nonaally sots bits 8 and 10 
for the user protection code 12. 

The filenane oxtenoion gives Additional infonaation abcut thii 
file, which is printed in sosm directory.. listings. The filcneoMi 
extension codes are: 



ASCII files, such as FORTRAN source. 

Save fomat files. 

Binary files j must be loaded with program 
LOADER. 

BASIC source file. 

BASIC compiled prograa file. 

FOCAL file. 

Temporary file 

BASIC data file. 
Listing file 
PAL source 



The protection word »ay be set by using PROTBCT: 

.PROT 0217 

This changes the protection of the file op«n under internal file 
number so that the file has an extension of .ASC, and that it cannot 
be read or written by any person other than its owner. 

This command changes the protection word of the file, currently 
opened under internal file number zero, to f217. Since bits 0-4 ere 
equal to 01, the files have an extension code of .ASC. Sine* bits 
8,9,10 and 11 are sot, the file will not be accessible to anyon»» 

other than the user. Tl:.e protect conunand cannot be used for MJ'D's and 

UFD's. See the REN lOT for details. 

How? PIP is called to do the actual protect word changing. The 
protect word is in word four of the name block for the file 
in the user's UFD. 
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blanX 


1 


.ASC 


2 


.SAV 


3 


.BIN 


4 


.BAS 


5 


.BAC 


6 


.FCL 


7 


.THP 


10 


blank 


11 


.DAT 


12 


.LST 


13 


.PAL 


14-17 


blank 
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Purpose 



The R command searches the directory of account 2 (Library) for 
a program and, if found, loads it and starts execution at location 0, 
If the program name is followed by a^munber, execution vrill start at 
that address instead of at 0. 



Example : 



• R CAT 



CAT will be executed, and will list the directory. R CAT is 
equivalent to RUN 2 CAT. 

How? SI calls PIP to open the file for the program, then passes 
a RPILE parameter block to the file handler in the Monitor 
to read it in. It then causes execution to start at loca- 
tion 0, or the address specified. The R and RUN commands 
operate slightly differently than the LOAD coiTOiand. If the 
program to be run is shorter than 4K, the unused portion of 
core may end up containing part of SI rather than what was 
there before the R or RUti. 

B.21 REDUCE 

Purpose 

To make a file smaller. REDUCE removes segments from the end 
of the file, leaving the others (if any) intact. If a file is 
reduced until there is nothing left, the file is deleted completely, 
including the entry in the user's directory. 

Example: 

.RED I 5 
.RED 1000 

The first command causes the file open under internal file number 
1 to be shortened by five segments. The second command deletes the 
file open undei^ internal file number 0, provided its length is 1000 
segments or less. 

Account 1 files (UFD's) cannot be reduced if there are any 
users logged in on or using the UFD , or if the UFD owns any filt 
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How? SI calls FlP to do the REDUCE. FIP finds the first segment 
of the file to be deleted, removes it from the directory, 
calculates its bit in SAT, clears that bit, and repeats the 
whole operation the desired number of times, 

B,22 RELEASE 

Purpose 

To release devices so that other people may use thtan. The 
opposite of ASSIGN. 

Example: 

• REL R 
•REL D 1 

The first command releases the high-speed reader. The second 
corrtmand releases DECtape unit 1. 

How? Provided the user owns the device, SI calls FIP which 

zeroes the proper word in DEVTBL, releases the DDB to free 
core, and charges the user's account for the elapsed time. 

B.23 RENAME 
Purpose 

To allow the user to rename a disk file. 
Example: 

•REN 2 HELPME 

The file currently open under internal file number 2 is given the 

name HELPME. The keyboard RENAME caiamand will not rename a l^D or UFD 
(which would change passwords) . 

How? SI calls FIP, which changes the neune in the user's UFD. 
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B.24 RESTART 
Purpose 

To set or determine the restart address. 

Example: *• •«• 

•RESTART 200 

• RES 

0200 

When the program is running and CTRL/C (tC) is typed, the Monitor 
causes the program to restart execution at the restart address. 
Thus, after the first command above has been given, if the user types 
CTRL/C (tC) during program execution, the effect will be a CLA CLL 
and a JMP to location 200. Monitor also clears the terminal buffers 
when it recognizes the tC. The second command determines the current 
restart address. 

How? SI sets the restart address in the user's job status 
block 0, the 7th word. 

B.25 RUN 

Purpose 

The HUN command searches under an account nuriber for a file. 

If it is found, it is loaded into core and executed. If the progra>'T! 

name is followed by a number, execution will begin at that address; 
otherwise it will begin at 0. 

Example : 

•RUN MYPROG 
•RUN 1234 PROGB 

The first conimand requests the program named MYROG to be loaded 
and executed. Since no account number is given, the user's account 
number is used to search for the program. 

The second command requests execution of ?R0<j3, stored under user 
number 1234. It is equivalent to LOAD 1234 PROGB; START 0. 
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How? SI calls FIP to open the desired file, then pass«3s a RFILE 
parameter block to the file handler in the Monitor to read 
it into core. It causes the user to start executing at 
location 0, or the address specified. 

B.26 S 

Purpose 

Stop the user's program. The terminal is in Monitor mode at this 

time . 

Example: 

*•( )*■*-* -./0123456789:;<«>?©ABCDEFGHIJKLMNOPQRStBS 



It is necessary to type CTRL/B, to put the keyboard in Monitor 
mode, before the S can be typed. If unwanted output is occur ing, 
the user can type CTRL/B twice to stop the output, followed by S and 
carriage return to stop the program. 

How? SI clears the run bit in the user's STRO. 

B.27 SAVE 

Purpose 

To write out portions of the user's core area to a dink file. 
The SAVE command has the same format as the LOAD command (see LOAD) . 

Example: 

•SAVE NEWPRO 

•SAVE PROGS 200 200 

Be sure that the named disk file exiats and is the proper size. 

How? SI calls FIP to open the desired file, and then passes a 
WFILE parameter block to the file handler in the Monitor 
to do the requested disk transfer. 
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B.28 START 

Purpose 

To begin or continue the program which is already in core. 

Example : 

. START 
..START 10 

The first command is similar to the PDP-8 continue key. A 
program is continued from the place where a HLT instruction was 
executed or a CTRL/B followed by S was typed. The second command 
clears the AC and LINK and begins execution at address 10. 

How? The START command, if an address is given, causes SI to 
alter the user's saved registers to the proper value. 
The run bit is then set, allowing the job to execute. 

B.29 SWIT CH 

Purpose 

To find the value of or set the user's switch register. The 
switch register is implemented by software to prevent users from 
having to set the computer's switches. There is no way that the 
user can determine the hardware SR setting, short of looking. 

Example : 

•SWITCH 3210 

• SW 

3210 

The first conraand sets the switch register to 3210. The second 
command determines the value from this point. Whenever the user does 
an OSR, the constant 3210 will be ORed into the AC. 

How? Each user's switch register is stored in the job status 
block 1. SI simply stores the SR there. 
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D.3 SYSTAT 



Purpose 



To obtain inforraation about the status of the SYSTEM. 

Example: 

•SYSTAT 

STATUS OF TSS/5.24 DEC PDP-8 tH AT 19:4j2t29 ON 20 JUL 74 

UPTIME 00X27:55 

^OB WHO WHERE WHAT STATUS RUNTIME 

1 0* 3 K00 SYSTAT RUN iQ 00:00:09 

2 0> 3 K04 PIP »BS tQ 00:00:08 

AVAILABLE CORE 0K FREE C0RE=3n 
BUSY DEVICES 
DEVICE JOB 
Kl 2 

219 FREE DISK SEGMENTS 
For installations with a line printer, type 

SYSTAT:L 
How? SYSTAT effectively causes a R SYSTAT. 

D.31 TALK 
Purpose 

To enable messages to be sent between terminals. 
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Example: 

.TALK 1 DID YOU HEAR ABOUT JOHN? 

If terminal 1 is not busy, the above message is printed on the 
console. If it is busy, SI will return the error message "BUSY." 
Account:? 1 and 5 are usually allowed to interrupt even when a terminal 
is busy. 

B.32 TIME 

Purpose 

To get information. 

Examples: 

.TIME 

00:00:05 
.TIME 
22: 12:38 
•TIME 2 
00:00:25 

The first example gives the elapsed processor time used by the 
user issuing the TIME command since he logged into the system. The 
second example gives the time of day. The third example gives the 
amount of processor time used by job 2 since the user logged in. 

How? SI takes the information from the proper location, convert.-; 
and prints it. 

B . 3 3 U NDUPLEX 

Purpose 

To take the user's terminal out of DUPLEX mode. (See DUPLEX) . 

Example : 

• UNDUP 
How? SI clears the DUPLEX bit in the user's keyboard DDB. 
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B.34 USER 
Purpose 

To find information about a selected job. 

Example: ^.., 

• USER 

JOB 01 C00J033 K00 

•USER 2 

vJOB 02 C0l,233 K0A 

The first conunand informs the user that he is job 1, account 3, 
and is at console 0. The second coimnand asks about job 2, which is 
being used by account 123 at terminal 4. 

How? SI takes the infonnation from various tables in cere. 

B.35 VERSION 

Purpose 

To determine the version number of the Monitor currently running, 

Example: 

•VERSION 

TSS/8.24 
How? SI prints the answer. 

B.36 WHERE 

Purpose 

To determine the status of the user's program. 

Example: 

.WHERE „ ^,„o 

SW=3210 PC=0000 L=«0 AC=0000 MQ = 5602 
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/ill registers jrelevant to the user are printed. SW is the switch 
register (see 5>WITCH) . This command is useful when used in con- 
junction with a CTRL/B, it enables the status of an executing 
program to be determined without stopping. 



How? SI takes the information from the user's job status 
block 1. 



APPENDIX C 

UNIMPI.EMENTED USER OPERATIONS 
(UUOs or user lOTs) 



This Appendix includes a numerical list of all the valid UUOs. 

I'jlienever an lOT is executed by a user, it causes a trap into the 
tor. The Moniiior looks for the lOT in a table, and one of several 
:qs happens. 

If the lOT is not found in the table, the Monitor simply ret'irns 
h^ user's program; the lOT functions as a NOP. 

If the lOT is resident - i.e., if code to handle the lOT is in 
^ ~ the Monitor executes the proper routine. 

If the lOT is non-resident, FIP must be called. If the lOT is 
.;;t- i.e., if all information transfer is through the user's 
■:.3ters - the lOT is ANDed with 0377 and stored in JOBLNK in the 

-•«3 job status block 1. If .the lOT is a long non-resident I0':\ 
•jiC v/ill contain the address of some parameters. These parameters, 
-.g v/ith the lOT, cire transferred to a free block, the address of the 
block is placed in JOBLNK, and FIP is called. Note that free 
3 always starts above address 377 so that FIP can tell whether 
:r.i{[< contains a free core pointer or an lOT. If FIP cannot fi;Tnre 

v/hy it was called, it executes a HLT. 



^ 6004 - GTF - Get Flag {PDP-8/E only) 

The link is placed into AGO, and the EAE GT flag (if presen'iy 
is placed into ACl. The rest of the AC is cleared. 

" 6005 - RTF - Restore Flags (PDP-8/E only) 

AGO is placed into the link, and ACl is used to set or clear 
the EAE GT flag. (if present) The AC is not change-i. 

6006 - SGT 

This "JUO causes a skip if the GT flag is set. Applicable 
only to 8E systems with EAE. 
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6010 - RRS - Read Reader String 

Before executing the RRS, load the Load AC with the a,ddress 
of a 2-word block, where; 

Word 1: is minus the number of characters to btj transferred. 
Word 2: is the address of user core, minus one, 

This starts the transfer. These characters will be read 
from the hiqh-speed reader and placed in the user's buffer. 
The AC is cleared by RRS, The two words are incremented 
according to the number of frames read. A system error is 
generated if the tape runs off the end. See 6431-SEA. 

6011 - RSF - Skip on Reader Flag 

The next instruction is always skipped. 

6012 - RRB - Read Reader Buffer 

The next character from the high-speed reader buffer is ORed 

into the AC. If the buffer was empty, the reader is started 

and this command is not executed until the buffer is nearly 

full. 



NOTE 



Successive RRBs will not retrieve the same 

character. 



6014 - RFC - Reader Fetch Character 

This instruction performs no operation. 

6016 - RRB RFC 
Functions as a RRB. 

6017 - RCB - Reader Clear Buffer 

Thi5> lOT causes the high-speed reader buffer to be cleared 
of any frames read from the tape but not yet transferred to 
the user's core. This is useful between tapes wh *n reading 
more than one tape. 

6020 - PST - Punch String 

Before executing PST, load the AC with the addres;; of a 
2-word block where word 1 contains the negative oi: the num- 
ber of characters to punch (word count) , and word 2 contains 
beginning address minus 1 of the string to be punched 
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(current address) . The block of data will bo punched and 
control returned to the IOT+2 v/ith clear AC. IE the PST 
does not punch all the characters,, control is returned to 
the IOTi-1. 



NOTE 



On most string lOTs, the following pro- 
qranuning sequence may be used: 



TAD ADDR 

PST 

JMP . -2 



ADDR* TWOWD 
TWOWD* -10 

DUF-l 



As chaiacters are placed into the punch buffer, the word 
count c.nd current address are updated. If word count reaches 
zero, the string lOT skips, going to the instruction follow- 
ing thf! JMP. However, if the buffer fills up, the Monitor 
returns control to the JMP. -2, causing the lOT to be retried. 
If des..re<i, the JMP. -2 may be replaced with a jump to other 
processing, which can later return to retry the string lOT. 
This allows a program to overlap I/O to a greater extent. 

6021 - PSF - Skip on Punch Flag 

The next instruction is always skipped. 

6024 - or 6026 - PLS - Punch Load Sequence 

The AC is placed into the punch buffer, but not cleared. 
Note that bit 10 of a PLS is ignored (6022 is a NOP) . 

60 30 - KSR - Read Keyboard String 

Execution of this instruction initiates a transfer of one or 
more characters from the user's keyboard to a designated core 
area. Before executing KSR, load the AC with the address of 
a 2-word block, where: 

Word 1: negative of the number of characters to be 
transferred. 

Word 2: address of the core area into which characters are 
to be placed, minus one. 
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'l'\\v transfer is terminated whon either: 

a) the indicated number of characters have been input, or, 

b) a delimiter is seen. At the end of the transfer, the 
word count and core address are updated and the AC is 
cleared. 

60 31 - KSF - Skip on Keyboard Flag 

Operation - the next instruction is skipped :.f the keyboard 
flag is set. The flag is set whenever a delimiter character 
is typed. If the KSF does not skip, and is followed by a 
JMP.-l, the user will be put into a wait state until a 
delimiter is typed. 

60 3 2 - KCC - Clear Accumulator. 

6034 - KRS 

A character from the keyboard buffer is ORed into the user's 
AC. If none are availcible, the job is put tc sleep until a 
delimiter is typed. User will be put into a wait state until 
a delimiter is typed. See 6400 - KSB. 

60 36 - KRB - Read Keyboard Buffer 

A combination of the 6032 and 5034 instructions. 

6040 - SAS - Send a String 

Causes a block of data to be output to the user's terminal. 

Before executing ap SAS, load the AC with the address of a 
2-word block, where: 

Word 1: contains the negative of the number of characters 
to be sent. 

Word 2: contains the address -1 of the first word of the 
string. 

The characters are stored one per word right justified start- 
ing at the address specified by word 2. Upon execution of 
SAS, the system takes only as many characters as will fit 
into the output buffer. It then makes the appropriate 
adjustment to word 2 to indicate a nev^ starting address and 
to word 1 to indicate the reduced character count. It then 
returns to the instruction following the SAS. If the 
character count is reduced to zero, the instruction follow- 
ing SAS is skipped. The instruction following the SAS should 
contain a JMP.-2 to continue the block transftjr of terminal 
characters. The AC is cleared by SAS. 

See 60 20 - (PST) for sample string programming. 
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6041 - TSF - Skip on Teleprinter Flag 

The next instruction is alwayn skipped. 

6042 - TCF - no operation is performed. 

6044 - 6046 - TLS - Load Teleprinter Sequence 

The contents of the AC are placed into the user's teleprinter 
buf f€!r . 

6200 - CKS; - Check Status 

Load the AC with the address of a 3-word block and execute 
the CKS. Upon return, the AC will be 0. STRO , STRl , and 
the device status register will be placed into the 3-word 
block. The formats of these registers are: 



STRO Bits 







Run Bit 


- 


Error Enable 


') 


JCOMBD 


3 


JSPEEK 


4 


JSACC 


fS 


JSIOT 


•7 


JSIOTC 


n 


JSINER 


9-11 


Error Code 



STRl Bits 







Timer 




File 




File 1 




File 2 


4 


File 3 




Keyboard 


i'j 


Line Printer 




Teleprinter 


3 


Reader 


:3 


Punch 



User program is in the run state 

Program handles its own errors 

Program was compute bound 

User has R privilege 

User is privileged account 

System use only 

System use only 

Not used 

system use only 

System detected error condition: 

1 Illegal lOT 

2 Swap read error 

3 Swap write error 

5 Disk file error 

6 Hung device 

Time is up 

Internal file is not busy 

Internal file 1 is not busy 

Internal file 2 is not busy 

Internal file 3 is not busy 

There is a delimiter in the 
input buffer 

Output buffer is not full 

Output buffer is not full 

Character in reader buffer 

Punch buffer is not full 
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10 Error System error detected, code in 

bits 9 through 111 of STRO 

11 VJait Job is not waiting. 

Device status register: See lOT 6772-RDS- for details. 

6400 - KSB - Set Keyboard Break 

This performs the same function as the Monitor BREAK 

command. 

Operation: Rather than activate a user's program to receive 
each character as it is typed, EduSystem 50 accumulates 
input characters until a certain character (s) , is seen. 
To tell the Monitor which characters to look for (these 
characters are referred to as delimiters) , load the AC with 
a 12-bit mask before executing a KSB. For eaci bit set in 
the mask, the Monitor considers the corresponding character 
or characters to bo delimiters. 

Bit Specifies 

= check rest of mask 

1 = any character is break 

1 301-332 (all letters) 

2 250-271 (all numbers) 

3 211 (horizontal tab) 

4 212-215 (line feed, vertical tab, form feed; 
RETURN) 

5 241-273 (I"#$%&' ()*+,-./:;) 

6 240 (space) 

7 274-300 (<=>?0) 

a 333-337 (^>|.^) 

9 377 (RUDOUT) 

10 375 (ALT MODE) 

11 any characters not mentioned above. 

Alternatively, clear the AC and execute the KSB. The Monitor 
will return the current value of the user's break mask in the 
AC. 

6401 - SBC - Sot Buffer Control 

SBC permits the user program to clear its terminal input 
and/or output buffer. Before executing SBC, set. bits and 
1 of the AC as indicated below: 

Bit 0=1 Clear output buffer. 
Bit 1=1 Clear input buffer. 
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6 40 2 - DUP - Duplex 

Performs the function of the DUPLEX Monitor command. No 
user rcjgisters are affected. 

6403 - UND - Unduplex 

Performs the function of the UNDUPLEX Monitor command. No 
user registers are affected. , 

6405 - CLS - Clear Status 

Load the AC with the address of a 3-word block. Any bits 

set in this 3-word block v/ill be cleared in the user's STRO , 

STRl , and device status register. Use this ICT with caution, 

6 406 - £>EG£ - Segment Count 

The ntmber of available disk segments is returned in the AC. 

6 411 - URT - User Run Time 

Load the AC with the address of a 3 -word block; where word 1 
conta.-ns the number of the job for which the run time is 
sough-. The run time is returned in the last two locations 
of the block. If job is specified, the run time of the 
current job is returned. The AC is cleared. 

6412 - TOD - Time of Day 

Load the AC with the address of a 2-word block. The value 
of the system clock will be placed in the two locations, and 
the AC will be cleared. 

6413 - RCP - Return Clock Rate 

The ruml:>er of clock-ticks per second (ten decimal) is 
returned in the AC. 

6414 - DATE - Date 

Retui"ns the date in the AC. The format of the date is 
( (YEAR-1974)*12-t-(MONTH-l) )*31+DAY-1. This number will 
overJrlow in 11 years, 4 days; Jan. 4, 1985 is the last day 
which will work without changing the base year. 

6415 - SY <i - Quantum Synchronization 

This instruction causes the scheduler to allow any other 
program to run. When this program is restarted after the 
SYN, it will have a full quantum (200 ms) of execute time 
vi^ithout being swapped out. 
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6416 - STM - Set Time 

Load the AC with a number. The job will be suspended for 
the number of seconds in the AC. The user's job is put into 
a wait state, and the two's complement of th€ AC is placed 
into CLKTBL, where it is incremented once a second. When 
it reaches zero, the job is allowed to run acain. 

6417 - SRA - Set Restart Address 

This command allows the user to specify an address to which 
control is transferred when CTRL/C is typed en the user's 
console. Load the AC with the restart address and execute 
SRA. If CTRL/C is detected, the program's input and output 
buffers are cleared, the AC and Link are cleared and control 
goes to the restart address. 

This function is also performed by the IlESTAFT Monitor 
command. 

6420 - TSS - Skip on EduSystem 50 

The next instruction is skipped and the current version 
number of EduSystem 50 is placed into the AC. This instruction 
is useful in programs which may run under EduSystem 50 and also 
under other operating systems, where it will function as 
a NOP. 

6421 - USE - User 

Returns in the AC the number of the current job. 

6422 - CON - Console 

Returns in the AC the console number assigned to the job 
whose nuimber was in the AC. If that job does not exist, 
-1 is returned. 

6423 - PEEK - Peek 

Allows the user to inspect the Monitor core; fields and 1. 
Load the AC with the address of a 4-word bloclc where 

Word 1 = Monitor field in bits 6-8 

Word 2 = Starting Monitor address 

Word 3 = Starting user address 

Word 4 = Two's complement of number of words to transfer 

The specified Monitor information will be transferred to 
the user's core, and the AC cleared. 
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PEEK is a privileged lOT. Privileged lOTs may be executed 
only in 2 cases: If the account number of the user ia 1 
throuch 3, or if the lOT is executed by a library program. 
The piivilege for the second case is enabled by the R, 
SYSTAT, LOGOUT, and KJOB commands, and is cleared every 
time SI is entered. The privileged lOTS are allowed if 
either privilege bit in STRO is set; if not, the lOT gen- 
erates; an error condition. 

64 30 - SSW - 53et Switch Register 

The content of the AC is stored in the user's switch 
regisl:er,, and the AC is cleared. The Monitor command 
SWITCH performs the same function. 

64 31 - SEA - Set Error Address 

This instruction allovi/s the user to specify an address to 
which control is transferred in the event of a system error. 
Load :he AC with an address before executing SEA. If a 
system error is detected, the Monitor simulates a JMS to the 
error address. The program counter is stored in the error 
address and control transferred to the error address +1. 
AC, Link, and input/output buffers are not affected. The 
error code of the system error is in STRO bits 9-11. 

The error routine must read these bits (by 
a CKS) to determine the cause of the error, then clear them 
by means of a CLS. 

The only error code that occurs in normal system usage is 
due to a hung device- The error occurs, for example, when 

1) the user attempts to use a punch not already turned on or, 

2) allows the paper-tape reader to run off the end of a tape. 
The illegal lOT error probably means that an assianable device 
lOT was executed without the device first being assigned. Swap 
and file errors occur if a hardware error is detected while the 
Monitor is swapping user programs, or readinq or writing file 
directories. These are system malfunctions from which there 

is no recovery. 

6440 - ASD - ASrSi^H^ /?eWt^ 

If the device specified by the content of the AC is avail- 
able, it is assigned to the user program and the AC is 
cleared. Otherwise, the job number of the device is placed 
in the AC. If the device does not exist, 7777 is returned 
in the AC. 
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4000 Paper-tape reader • 

4001 Paper-tape piinch 

4003 Line Printer 

4004 Card Reader 

4005-fN DECtape unit N, N=0-7 

4015+N RK8E drive N, N=0~3 

The assignment is in effect until a correspondiiig REL instruction 
or LOGOUT. 

The same function is performed by the AS£JIGN Mo;iitor command. 

NOTE 

The device number for the line printer 
has been changed to 4003 from 4002. 

6442-RZL-Release Device 

The device specified by the contents of the AC is released 
(providing it was ov>med by the user executing tlie REL) . The 
AC is cleared. Releasing a device mcikes it available to 
other users. 

The same function is performed by the RELEASE Monitor 
command . 

6600-REN-Rename a File 

REN is used to change the name of a file. Load the AC witli the 
address of a 4-word block where: 

Word 1: contains the internal file number associated 

with the file whose name is to be changed. 

Words 2-4: contains the new nsime. This name is in 5-bit 
characters and packed two in a word. 

The same function is performed by the RENAME Monitor command. 
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l-r.ien oxecnitec under actioimt 1, the REN lOT has a special function. Load 
■:: v;itii the address of a four v;ork block, where: 



Word 1: 
Words 2-3 
Word 4: 



Contains the account number of an existing user 
Contains the desired password for that account, and 
Contains the desired disk quota for the user. 



The UFD to he. renamed need not be open. The quota is placed in the word 
■rerved for the protection code in files. For UFD's, bits through 5 of the 
.-ita are reserved for future use. Bits 6-11 contain the disk quota for that 
;. ount divided by ?.5. The quota word for the MFD contains the grace quota. This 
; a 12-bit number [not divided by 25) which determines how many segments over 
ir; quota a user may extend his files. 

Upon return ::rom all file lOTs , the AC is either cleared or contains 
- '; of the following error codes : 

4000 There was no file open on the specified internal 

file number. On an open command, tiiis error indicates 
the open failed because of a 1 ck of table space or 
free core. 

4400 Attempting to alter a file which is open to another 
user (or to one user?) 
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- "- '- -or a user whose directory is 

full, or who hiii-i ;ceacJied or exceeded his disk quota. 

54 00 Bad directory 

6000 File protection violation 

6400 Invalid file name 

7000 Attempting to open a nonexistent file 

7400 The disk is full. 



)01 - OPEN - Open a file 

Open is used to associate a file with an internal file number. 
This is necessary because all file operations are in terms of 
internal file numbers. Before executing the OPEN lOT, load the 
AC with the beginning address of a 5-word block, where: 

Word 1: contains the internal file number. 

V"/crd 2: contains the account number of the file owner'. 
If O, the account number of the current user is 
specified. 

Word 3-5: contain the name of the file to be opened. This name 
is in 6-bit characters packed two to a word. 

It there was another file associated with the internal file number, 
be ford the execution of the OPEN lOT, it is closed automatically- 
This; is done before the new file is associated with the internal " 
n\iruber. Account 1 may open any used file and not be protected, 
regardless of the setting of the file's protection word However. 
account 1 files, (MFD,UFD'S), are always write-protected even aya.. 
account 1. 

0:> - CLOS - Close a file 

CLOS terminates the association between files and their internal 
file numbers. Before executing CLOS, load the AC with a selectic". 
pattern for the internal file numbers whose associated files are •- 
be closed. The file is closed if bit I is 1, where? I = bit 0,1,2- 

The same function is p€?r formed by the CLOSE Monitor command. 

i3 - RFILE - Read file and - 66 05 - WFILE - V7rite file 

Once the association of a file with an internal file nuniber has - 
been raade , these lOTs allow the actual file reference to be made, 
-re illegal on a file that has not been opened (associated with 2" 

nternal file number) . 
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jar"', or vj.rite a file, load t.hn AC vzith the address of a 6 -word 
I;, t.hGn execute llie lOT.. Tho format for the 6 --word block is: 

] Ir. contains the high-order file word address 

] 2: contains the internal file number. 

i 3: contains the negative of the number of words for the 
operation. This number is either the number of words 
to be read or the number of words to be v/ritten. 

d 4: contains a pointer to the beginning address -1 of a buffer 
located in the user program. On a read operation this 
buffer receives the information from the file; on a write 
operation this buffer holds the information that is to be 
sent to the file. 

:d 5: contains the least significant 12 bits of the initial file 
word address to begin the operation. 

:d 6: contains an error code: 

If no error 

1 If parity error 

2 If file shorter than word count 

3 If file not open 

4 If protection violated 

. read or write begins at the word specified by words 1 and 5. 
For exam^Dle : 

TAD X 
WFILE 



X* .♦I 



1 

-200 

6477 

200 

jans : write 200 (octal) words starting at word 200 of the file assvocia- 
■th internal file number one from a core area starting at location c50'^ 
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After completion of the transfer, the word count (word 3) iind 
core eiddress (word 4) are updated. If an error was detected 
the appropriate error code is placed in word 6. 

>b04 - PROT - Protect a file 

To use, load the AC with the desired protectictn word in bits 
0-4 and 7-11, and the internal file numlDer of the file to be 
protected in bits 5-6. The meaning of the bits is explained 
in the PROTECT Monitor command. (See 6600-REJF for error 
conditions.) For directories, the REN lOT mu£;t be; used. 

o605 - WFILE - Write a File 

^>?FILE uses the same calling form as RFILE; see 6603 - RFILE. 

This command performs the same function as the SAVE Monitor 

command. 

6610 - CRF - Create a File 

The user can reque^st the system to create a new file of one 

segment. The user* provides the new name for the file. Load 

tlie AC v/ith the beginning address of a 3-word block, where: 

Word 1 through 3: contains the 6-character name. 

If there is some reason why the request cannot be granted, 

the system will return a non-zero error code in the AC. 

(see 6600-REN for error conditions.) The protection code 

of a newly created file is 12. When account 1 creates a file, 

the two accounting words are zeroed by file^ as is the file 

itself. 

This command performs the same function as the CREATE Monitor 

command. 

6611 - EXT - Extend a file 

To extend the length of an existing file, that file must be 
currently open. Load the AC with the beginning address of 
a 2 -word block, where: 

V/ord 1 : contains the internal file number of the file to be 
extended. 

Word 2 : contains the number of segments the system should 
append to the file. 
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Wl-ien a t: 1 ^^ to be extended, a check is made to see if the entire 
extend V)- 1 succeed. If not, the extend will not be started. If 
an extenc auses a users total file size to exceed his quota, th^ 
-Monitor vi 1 allow that file to be extended only until the quota has 
been exceO' ed by the grace quota. The first time that any file is 
extended s- that its owning account is over quota, the Monitor will 
print an i. formational message such as: 

MY f::le exceeding disk quota 

''Tie re MYFT E is the name of the file being extended. 

"*nen a use. has reached his quota, he may no longer create any file. 
'-'■in attempt ^o extend an account one file (MFD or IJFD's) will always 
-"ail. 

:-^', for sol 2 reason,, the request to extend a file cannot be granted, 
5 -he AC wil contain 4000, 4400, 6000, or the number of segments it 
! -^siied to ppend. See 6600~REN for error conditions. 

"his comma 5 performs the same function as the EX^CEND Monitor command. 

'-^^12 - RED- Reduce a file 

; To re ace the ].ength of an existing file, that file must be ciir~- 
: rentl open. Loaid the AC with the beginning address of a 2-word 
block where: 

Word : contains the internal file number of the file to bo 
reduced. 

i Word,: contains the number of segments to be removed. 

,i If negative, the file will be deleted. 

(■. 

' -^^.s reque t is granted unless the file to be reduced is currently op»ened 

5 '- anotheii aser or if the file is write protected against the user. See 

;*500-REN i; r error conditions. A UFD can only be reduced if the account 
; -s inacti\' and owns no files. Reducing a UFD always causes it to be 
I -dieted iii^^ord 2 is non-zero. 

■^-13 - Fll:^ - File Information 

,- FINFr-iables a user program to determine what file, if any, is 

associated with an internal file number Load the AC with the begin- 
i ningi3dress of a 7-word block, where: 

\ Word I : contai.ns the internal file number for which the user 

: progr^im wishes information. 

Word; 2-7: contain the information that the system returns after 
> executiing FINF. 

■'•^ Word:: contains the account number of the ov/ner, or zero, if nc 

file nuiTiber, that is, the file is not open. 

Word 3-5: contain the name of the file in 6-bit code. 
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)rd 6: contains the protection code. See the Monitor command PROTil 
(Disk quota if directory) 

.n""" 7: contains the number of segments which compose the file. 

lis coimuand performs the same function as the F Monitor command. 

^14 - SIZE - Return segment size 

This UUO sets the user's AC to 0400, the size of a disk segment. 

J 14 - LIN - Log In 

When SI calls FIP with a 6614, FIP will perform a LOGIN. A prog:;: 
cannot execute this lOT (see SIZE) . 

J 15 - LOGOUT - Log out 

This is a triple purpose lOT. If the AC is zero, it will return 
th'.^ r.umher of users logged in with the same account number as the 
user e^xecuting the lOT. If the AC contains the job number of tb- 
uGii's job, the user will be logged out. All assigned devices ax • 
releeised, and user's terminal becomes inactive. LOGOUl? is a priv- 
ileciced lOT . See 6423 - PEEK for details. If account 1 executed 
the lOT with AC equal to negative job number, FIP will reset all 
'ZPIJ and device time accumulators in the MFD; this is used by the 
Reset command in CAT. 

J 16 - WI-IO - Who 

The account number and password of the current job are returned 
to the 3 -word block whose siddress is in the AC and the AC is 

cleared. 

3l7 - ACT - Account 

Load the AC with a job nuraljer. The account number of that job. 
is returned. If the AC is 0, the account number of the current 
job is returned. If the requested job does not exist, is 

returned. 

)32 - RCIIA - Read card Alphanumeric 

rJ4 - :iCRB - Read Card Binary 

:36 ~ RCRC - Read Card Compressed 

- oad the AC with the address munus 1 of an 80~word buffer. A ce: 
±3 read and the data is put into the buffer in the same form as ^ 
corresponding hardward lOT. The UUO returns in the AC the numb^:: 
characters successfully transferred to the user's buffer. (See ^^ 

6 772 - RDS.) 
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; - LvST - Line printer Send-a String 

Performs the fsame function as a 6020 - PST, except that the output 
goes to the line printer. 

:. - LSF - Line printer Skip on Flag 

The next instruction is always skipped. 

>t, - 6664 ~ LPC - Line Printer print 

The contents of the AC are loaded into the line printer buffer. The 
AC is not cleared. Note that bit 10 of the lOT is ignored; 6662 is 

,5 - DLAG - Disk Load Address and go 

Allows the user to read or write on the RK8E.. To use, load the AC 
> with the address of a three word block, where: 

V7ord 1: Bit = for a read, 

=1 for a write 
Bits 3-8 contain the number of pages to 

read/write, 1 to 40. 
Bins 9-10 contain the drive number to3. 
Bit 11 contains the high order sector address. 
Word 2:^ contains the core buffer address minus one. 
Word 3 : «-i contains the low order sector address. 



^. return, the AC contains the number of blocks transferred. To determi 
3r conditions, see 6772-RDS. The disk transfer is made in 400 (octal) 
;ks. Each RK05 drive contains 14540 (octal) blocks. To specify- t?iG 
:;ial block number, the high order bit goes into word 1 of the parameter 
;,:X, and the remaining 12 bits into word 3. If the transfer requests ar 
• number of pages on a v/rite , the last page of the last block on the di;:: 
[contain zeros. Upon return, the AC contains (P+l)/2, where P is the 
ner of pages successfully transferred . 

4 - DTXA - DECtape go 
Load the AC with the address of a 3-word block, where: 



VJord 1 
Word 2 
Word 3 



Contains the unit, direction, and function 

Contaiins the block number 

Contains the core buffer address minus one 



;3 0-2 of word 1 contain the unit number. Ei't 3 of word 1 shcul.u ';'•• £:et 
p/W in reverse. 3its 6-8 of v;ord 1 should be 2 to read, 4 to write. 

■I return, none of the parameters are altered, and the AC is cleared. Tj 
: should execute a 6772-DTRB instruction to find out whether tlie trans f' 
. successful . 
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Note that this allows the user to read or write a block in the 
reverse direction. The user must be aware that if a block is 
written in one direction and read back in the opposite direction, 
the order and contents of the data words will be changed. 

771 - DTSF - Skip on DECtape flag. The next instruction is always 

skipped. 

77 2 - DTR3 - Read DECtape Status B, or 

772 - RDS - Read Device Status 

The information obtained pertains to the RK8E, DECtape, or Card 
Reader, depending on which was most recently used. The contents 
of the device status register are: 

RK8E: RK8E Status Register 

Bit 0: Control done 

1: Heads iji motion 

3 : Seek fail 

4 : File not ready 

5 : Busy error 

6: Time out error 

7 : Write lock out error 

8 : CRC error 

9: Data request late 

10: Drive status error 

11: Cylinder address error 

DECtape: TC08/TC01 Status register B 



Bit 
1 
2 
3 
4 
5 
11 



Error flag 
Mark trsick error 
End of tape 
Select error 
Parity error 
Timing error 
DECtape flag 



he status register for DECtape may also include 4000 or 4001. These 
oftware aenerated errors such as block number out of rang. 
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Card reader: The device status register contains the addror,;: c>.': ;.' 
last word of data transferred to the user's buffer. In addition, t 

device status register may contain 7777. This indicates that CTRL, 

follov;ed by S was typed v;hile a DECtape or RK05 transfer was .in 

progress, and the transfer was not finished. 

■73 - DTSF DTRB - 

The status is placed into the AC and the next instruction is s^-^.ippc 
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APPENDIX D 
DETAILS OF MONITOR'S DATA BASE 



. INPUT/OUTPUT DATA BASE 

All I/O, except for the disk, is controlled from a single, fixed- 
j gth table, DE\7TBL. Actual data about the status of each device is 
td in a. Device Data Block (DDB) . DDBs are dynamically assigned 
i cks of free core. The actual data to be transferred is contained in 
j:fers. In the case of terminal I/O, the high-speed reader and punch 
;■. the line printer, these buffers are dynamically assigned blocks of 
.-e core. One or more (linked) blocks of free core make up a buffer, 
jiuinals are consi(iered to be two devices: a keyboard and a tele- 
;.ater. Each as a DDb, and each has its own buffer. Some of the assign 
; ices, which have higher data rates, do not use dynamic core buffers. 
•2 DECtape uses a fixed 201 word buffer, the disks and card reader 
'-nsfer directly to and from the user's core area. 

The tables, DD13S, and buffers are linked together by pointers. 
f/TBL is, in fact, a table of pointers. If a device is inactive (a 
«rminal not logged in or other devices not assigned) the corresponding 
jble entry is zero. If the device is in use, the table entry is a 
jinter to its DDB. The DDB for each device also contains pointers, 
^3 fill, and the empty pointer. The fill pointer points to where the 
rxt character to be put into the buffer should go; it points to the 
isad" of the buffer. The empty pointer points to the next charcacter 
; be taken from the buffer. Each buffer block contains in its first 
,rd a pointer to the next block. The last block in the buffer contains 
fill count indica'iing to which position in that block the next Thar- 
:ter should go. Figure D-1 shows the relationship of tables, DDP.3, 
fd buffers. 
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Figure D-1 . Relationship of DEVTBL, DDEs, and Buffers 

DEVBL is set up with the terminal entries first, the entries for 
the rec-idcr, punch, an unused entry, the line printer, the card reader 
second, eight entries for DECtape, four entries for RK05 third, and 
finally a 7777 terminator. The number of entries for terminals, and 
hence the size of the table, is dependent on the configuraition 
parameters specifying the numt)er of terminals. DEVBE marks the 
beainning of the assignable de^vice section of DEVBL, which always con- 
t is 17 entries even though all these devices may not be included in 
the system. All slots in DEVTBL which correspond to non-existent 
devices are filled with dumm.y pointers to prevent assignment. See . 
Figure D-2. 

Device Data Blocks are always 8-word blocks assigned from free 
core. The DDEs for the assignzible devices exist for as long as the 
device is assigned. For all DDEs, bits 7 through 11 of word zero con- 
tain the unit number. Bits 7 through 11 of word .1 contain the job 
number which owns the device. Word 3 contains the time at which the 
device becomes active. This 12-bit time is taken from bits 3 through 
11 of CLK2, and bits through 2 of CLKl . The use of the remainder of 
the DDE depends on the particular device. 

There are a number of status bits in word zero of the keyboard 
DDE. The XON bit is set when a buffer is almost full and XOFF is sent 
to the terminal. When the buffer is emptied, XON must be sent. SI ^^ 
set to indicate that the terminal is in Monitor mode. DUP is set to -■ 
cate that the terminal is in duplex mode. SICOM, when set, indicates 
that zr.e user has just finished typing a command to SI. 
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Figure D-3 . Keyboard Device Data Block 
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Figure D-4 



Device Data Block-Teleprinter, Reader, Punch 
and Line Printer. 



Free core buffers are packed 10 charachters to a block. Characterij 
1 throught 7 go in bits 4 through 11 of words 1 through 7. Characters 
8,9, and 10 are split ^md packed into the high-orde.«r bits of words 1 , 
through 6. Bits through 3 of word 7 are unused. See Figure D-5. 
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Figure D-5- Character Buffer 
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igure D-6. Device Data Block 
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Figure D-7. Device Data Block 
RK05 



). 2 USER PROGRAM STATUS 

All job status information is based on a single, fixed-length 
;ble in Monitor core, JOBTBL. JOBTBL has a 1-word entry for each 
ossible job. If the job doeg not exist, that is, no one is logged in 
- that job, the corresponding entry in JOBTBL is zero. If that ]ob 
'res exist, the entry contains a pointer to the first of three (linked) 
-b" Status Blocks. These contain complete information about the running 
Jate of that job. For each file open to that job, there are two 
jditional blocks; one additional block contains information about the 
Jle, and the other additional block indicates where it is on the disk, 
hile a file transfer is in progress, still another block exists which 
•ntains parameters for the transfers. Finally, when executing an JOT 
iich requires a FIP call, a block may be set up to pass the parcuiP.Gters 
?e Figure D-8 . 
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Figure D-8. Job Status Information 
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The three job status blocks exist for all jobs They contain tli 
saved state for the job, AC, PC, LK, and the EAE registers They als: 
contain the status of the job's I/O. See Figure D-9.. 
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Figure D-9. Job Status Blocks 



STRO contains status bits "which are not directly associated with 
l/o. STRl contains bits which may be considered flags. They are set 
and cleared according to whether the associated device is ready or not 
re^ady. The "wait mask" masks STRl. When a job is waiting for a 
device, a single bit in the wait mask, corresponding to the device bit- 
in STRl, is set. Wlien that device finishes, its bit in STRl is set. 
STRl and the wait mask are "ANDed" together, aad if the result is non- 
zero, the scheduler knows that the job should bcj run. When a job is 
not waiting, bit 11 (the dummy wait bit) is set in both STRl and the 
wait mask, allowing the job to run. See Figure D-10. 
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The DECtapo, card reader, and RK8E are exceptions. When a ^ol) i 
,;aiting for one of these device, the v/ait mask is set to zero nits 
0-8 of v/ait 2 are set to the address of the DDB for the device, and 
;3its 9-11 are set to 1 or 2 for DECtape, 3 for RK05 or 4 for the card 
reader. 



If a user program lOT or an SI cominand requires FIP to be called, 
an lOT parameter block is set up to hold the lOT and its parameters 
A pointer to this block goes into JOBLNK. If a FIP lOT is to be 

]2xecuted which requires no parameters, the lOT itself goes into JOBLNK, 

';:ind no lOT parameter block is set up. 

V Within Job Status Block 2 are four registers which correspond to 
[the four possible internal files. If a register is zero, no file is 
iopen on that internal file. When the file is opened, a file control 
jblock is set up and a pointer to it is put in Job Status Block 2. At 
the same time, the first 8-word File Retrieval Information Block for 
[that block is fetched from the UFD and is set up in another block of. 
jfree core. Referred to as the file window, this retrieval block i s 
used to calculate addresses for file reads and writes. If part of the 
file being accessed does not correspond to this window, FIP is called 
to move the window to the appropriate area. Word 1 of the control 
block remembers which retrieval information block is in the retri^^^'il 
window. 



When a user program executes an RFILE or WFILE, the transfer 
parameters (word count and file address) are stored in the file c';r.^:rol 
^ block. The file address is an address within the logical file. l>.t; 
address of the transfer parameters in the user program is also s-i-cd. 
Then, using the file^ v;indow, the logical file address is reduced to a 
j physical disk address.. A pointer indicating where to go in the 
; Monitor, when the transfer is complete, is also stored. This block is 
:also linked into the disk queue (DSUTBL) . See Figures D-li and D-12. 



CLKTBL is used to execute the STM instruction. It has a 1-word 
entry for each job. If that job is not waiting out an STM, its entry 
is zero. If it is waiting, the entry contains the number of seconds 
left to wait (in 2's complement). When the counter goes to zero, the 
timer flag for that job is set. See Figure B-13 . 
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Figure D-13. CLKTBL and TTYTBL 



The TTYTBL table has a 1-word entry for each possible system job 
Each entry contains the number of the terminal associated with that . 
job. See figure D-13, 
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MONITOR SCHEDULING DATA BASE 



DEVTEL, JOBTBL, and related status blocks maintain some EduSystem Jl^ 
status information relating to individual jobs. The monitor also main*. 
tains some of its own tables. These are used primarily to schedule. .. 



CORTEL contains the status of the user fields. It is a 7~word . 
table in monitor core, each v;ord corresponding to a core field. Within. 
each entry, bits 7 through 11 contain the job number of that field. If; 
the field is empty, a zero is stored there. If the job that occupies, 
a f;.elu is not completely there, bit is set to indicate a swap is in 
t^rociress. A job is considered to be in a field from the time it is 
schecuied to be swapped in until the time it is completely swapped out. 
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Bit ] ;ir. sot if 'Jiq job in that core field cannot be swapp 
Bit 2 is r.rr':. if the job in that field has not been run. It can 
sv;apped out until it has been run. FIP and SI are called phant 
the sense tliat they run in place of a user job. Therefore, whe 
is running, the calling job number is stored in CORTBL. Bit 3 
set to remember that it is actually a phantom. Phantoms can ri 
in field 2. CORTBL has an entry for every core field but fielc 
whether it is available or not. At startup time, the Monitor': 
and nonexistent fields have their lock bits set to prevent use. 
Figure D--14. 
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Figure D-14 



CORTBL 



PRGTBL maintains information on what program each user is 
It has a 3 -word entry for each possible job. When a user type: 
or RUN command, the filename (one to six characters pa>.-<cd m . 
format) is stored in PRGTBL. This information is used solely ; 
EduSystem 50 SYSSTAT . 

DSUTBL is the disk request queue. It contains a 4-word ei 
each, core field in the system. A 7777 word terminates DSUTBL. 
each 4 -word entry there is a register for each of the four pos' 
files open to the user currently in that core field. If the e. 
zero, there is no file transfer pending for the internal file 
jser in that core field. If the entry is nonzero, it is a poi 
a parameter block (the RFILEA^FILE parameter block) which dor.c 
:he transfer to take place. A pointer, DSKPTR, cycles through 
:o do transfers. See Figure D-15. 
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Figure D-15. DSUTl 



DISK FILE DATA BASE 

For each EduSystem 50 account number ther is a separate disk 
2 library that contains named files. The User File Directory, 
:::h :)ntains the filename (and some associated information) and 
:2 location information for each file, controls this library. 
name is in an 8-word name block; the retrieval information is 
jne or more 8-word file retrieval information blocks. The UFD 
2lf is stored in disk segments, up to a maximum of seven. 



The first 8-word block of the UFD is a dummy block. 
IS all zeros except for a pointer to the next block. 



It con- 



The MFD is identical in form to a UFD. The only difference 
in th€s contents of the name block. Where the UFD has six file- 
5 characters packed into three words, the MFD has the account 
3er in the first word, then two words of password. Altogether, 
^~^e three words are the name of the associated UFD. See Figure 
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Figure D-16. File Directorie 



D.5 FILE PIIAI^TOM DAT7^ PASE 



The primary data base of the File Phantom is the d: r=.:otor ;c3 , 
MFD and UFDs . Althoiujli they may be accessed as files by :\ wmix: ] '.yj 
in with the system password, these directorie- are norrr.cMy u:.,od or. 
by ?IP. In addition, to keep track of disk usage, FIP n,a:ntci:r, s ri 
Storage Allocation Table (SAT). The SAT is a bit map c ■' '.liO disk ,: 
spacu. The 12 bits in each SAT word correspond to 12 dj.Sf'. secir.onts 
1 if the segment is used, if it is available. /At refrc^.h. time IN' 
sets all bits which correspond to nonexistent disk to Is. Tlit- .SAT 
located at the top of FIP's 4K. It is therefore sv/appcd into cc.:.n.; 
FIP. If the SAT is updated, it is v/ritton b.ick to the disk. D,. k.'.v 
SAT is a register, SATCIJT, v/hich records the number of free di,-:-: :.>•:.■ 
ments. See i'igure D-17. 
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Figure D-17. SAT 

FIP also inaintainG some convenient tables within its ovm 4K area. 
Theiie tables allow FIP to get at frequeiitly used information quickly. 
For example, when a user logs in, the retrieval block, which indicates 
\vliere his U"D is located, is fetched from the MFD and stored in a table. 
FIP need not then scan the MFD for this user every time he opens a file. 

J0RT7\P. contains a 1-word entry for each possibJe systera job. If 
no one is logged in for that job, the entry is zero. If there is a 
Uoer logged in, the account number is stored. (Do not confuse i-'IP's 
JOBTAB with the Monitor's JOBTBL . ) See Figure D-IG. 
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Figure D-18. FIP Tal.les 

EI-TTDL contains an 0-word block for each possible system job. 
Withm these eight v;ords are four 2-word entries, one for each possible 
open file for that job. If the entry is zero, .the file is not open. 



D-12 



If the file is open, the first word points to the entry in 
RETTBL for this file. Th^ second word points to the location 
within the user's UFD where the File Retrieval Information Blocks 
for this file begin. 5)ee Figure D-18. 

UFDTBL and RETTBL work together to maintain retrieval inform- 
ation for all UFDs in use within the system. A UFD is in use if 
one or more users are logged in with that account or if the user 
has opened a file from the library of another user. There is only 
one entry in OT'DTBL and RETTBL for each UFD, even if more than one 
user is using it. 

UFDTBL is a table of 4 -word entries. The first is the account 
number of the UFD which is open, the second is the number of users who 
fiave access to it. (this number is decremented each time a user stops 
using that UFD. If the count goes to zero, the entry is removed from 
iJFDTBL and RETTBL.) The access count is in 2's complement form. 



' RETTBL contains the File Retrieval Information Block for the UFD 
|hich corresponds to the? account nurober in UFDTBL. There are no 
iointers between the two tables. Entries correspond positionally . 
?he number of entries in these tablets is at least the number of on-line 
isers. The numl^er of additional entries depends on the amount of file 
;haring. For instance, the library UFD is invariably open to several 
i&ers . See Figure D-19. 
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UFDTDL and RETTBL are initialized to have the system account 
(#1) open as the first entry with an access count of 1 (actually -1) . 
This allows FIP to get at the MFD while processing a LOGIN request. 

All FIP tables except the SAT are cleared at system startup time 
bAT is cleared at initialize time. 
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APPENDIX E 
ASSEMBLING AND LOADING EDUSYSTEM 50 FROM SOURCES 

E . 1 ASSEMBLING EDUSYSTEM 50 MONITO R 

f Use the following command lineg under OS/8 version 3 to assemble 
Monitor, where CONFIG. PA has been modified to reflect the desired 
,conf iguration : 

•PAL SI<CONFIG*PARA#SI/K 

•PAL FIP<CONFIG*PARAjFIP 

.PAL 3;MIT<C0NFIG*PARA> IMIT 

• PAL TSa<C0NFIG>FARA*T;38*TS8II/K 

' When using CREF, the M option v;ill be necessary. The binaries 
may be punched on paper tape, or on 20K or larger systems, a shortcut 
may be taken. Type, under OS/8, 

.LOAD INIT>SI*FIP^TS8/G = 2/4200 

Use the C option in INIT to write fields through 4 to tracks 
through 4 on the disk, initialise the system, load PUTR using the 
option, start the system, log in under account 2, type "START / V , 
and the system is up. 

E . 2 ASSEMBLING AND LOADING BASIC 

To assemble BASIC under OS/a version 3. type: 

.PAL BASED 
.PAL BASCOM 
.PAL BASLDR 
•PAL BASEXC 
.PAL BASICN 
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) create a SAVE format file, the binaries must he. transferred to 
tSystem 50 library. Then, perform the following under EduSystem 50 



•CRE BASIC;OPE 3 BASICiEXT 3 37 

•R LOADER 

I:NJPUT-BASED 

OPTION- 

tBS 

•SAVE BASIC^R LOADER 

I NPUT-BASCOM 

OPTION- 

tBS 

• SAVE BASIC 61^^^ 400;R LOADER 

INPUT-BASLDR 

OPTIO>J- 

tBS 

.SAVE BASIC 131.50 ^00; R LOADER 

IMPUT-BASEXC 

OPTIO^J- 

tBS 

.SAVE BASIC 137M ^00;R LOADER 

INPUT-BASICN 

OPTION- 

TBS 

.SAVE BASIC 1/4157 400 



SSEMBLING AND LOADING THE FORTRAN SYSTEM 

o assemble the FORTRAN system under OS/3 version 3, type: 

.PAL FORT^DECODE 
.PAL FOSL#DECODE 
.PAL FDCOMP 
•PAL FOSSIL 

o create the new SAVE files under EduSystem 50, first type 

•CRE FORTJOPE 3 F0RT;EXT 3 5 

•CRE fosl;ope 3 fosl;ext 3 5 

.CRE FDC0MP;0PE 3 FDCOMPiEXT 3 14 

•CRE fossil;ope 3 fossil;ext 3 9 
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